Mercurial Mercurial > oss > FCL > sftools > dev > ide > carbidecpp / annotate
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
core/com.nokia.carbide.cpp.doc.user/html/tasks/start/carbide_debugging.htm
author fturovic <frank.turovich@nokia.com>
Wed, 06 Oct 2010 10:31:32 -0500
changeset 2131 ff0156b93599
parent 1791 727385d8e2b3
permissions -rw-r--r--
moved inf, mmp, remote conn, and views to project folder
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
400
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     2
 
<html>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     3
 
<head>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     4
 
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     5
 
<meta http-equiv="Content-Style-Type" content="text/css" />
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     6
 
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     7
 
<title>Debugging a Symbian OS Program on the S60 Emulator</title>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     8
 
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
     9
 
</head>
1791
727385d8e2b3 added new customize carbide section and some relinking done for deleted duplicate page
fturovic <frank.turovich@nokia.com>
parents: 1490
diff changeset 
    10
 
<body >
2131
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset 
    11
 
<h2>Debugging a Symbian Program</h2>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset 
    12
 
<p>Use the Carbide.c++ debugger to debug a compiled Symbian program in an emulator or on-device. The same process works for other emulators and target devices as well.</p>
1490
811926adaf5e added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    13
 
<p class="note"><b>NOTE</b> This example uses the Symbian Emulator included with the Symbian^3 SDK. The steps are identical for on-device debugging, although a <span class="code">.sym</span> file is not needed for emulator builds.</p>
400
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    14
 
<div class="step">
2131
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset 
    15
 
  <h4>Debugging a Symbian program</h4>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 400
diff changeset 
    16
 
<p class="note"><b>NOTE</b> You can only debug compiled programs. Use the <a href="../projects/prj_build.htm">Build Project</a> command to compile project sources into a binary file if you do not already have an executable in the project. A symbolics (<span class="code">.sym</span>) file is also required for debugging on a target device. Ensure that a <span class="code">.sym</span> file has been created. If you are importing an existing application, you may have to rebuild the application and create a related <span class="code">.sym</span> file. Make sure a <span class="code">.sym</span> file has been created in the output directory.</p>
400
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    17
 
  <ol>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 400
diff changeset 
    18
 
    <li>Set a breakpoint in the MyProject program</li>
1490
811926adaf5e added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    19
 
    <p>Open the <span class="code">\src\OortCloudAppUI.cpp</span> file and <a href="../breakpoints/pgm_bp_setting.htm">set a breakpoint</a> in the <span class="code">HandleCommandL</span> routine.</p>
811926adaf5e added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    20
 
    <p align="center"><img src="images/debug_set_breakpoint.png" width="678" height="281" /></p>
811926adaf5e added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    21
 
  <p class="figure">Figure 1 - Breakpoint set in COortCloudAppUI::HandleCommandL routine. </p>
811926adaf5e added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    22
 
  <li>Launch the Carbide debugger and Symbian  Emulator</li>
811926adaf5e added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    23
 
  <p><a href="../../debugger/debug/cmds_starting.htm">Start</a> the Carbide debugger which launches the Symbian  Emulator, then installs and launches the executable. For on-device debugging, the application is installed on the target device.</p>
811926adaf5e added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    24
 
  <p>The OortCloud application launches (Figure 2). </p>
811926adaf5e added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    25
 
    <p align="center"><img src="images/wnd_symbian_emulator_01.png" alt="Symbian Emulator" width="238" height="458"></p>
811926adaf5e added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    26
 
    <p class="figure">Figure 2 - OortCloud application running on Symbian Emulator </p>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 400
diff changeset 
    27
 
    <p class="note"><b>NOTE</b> For SDKs prior to the S60 5th Edition it may be necessary to locate the installed application and manually launch it in the emulator or on the target device.</p>
1490
811926adaf5e added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    28
 
    <li>Click the Options soft-key on the Symbian Emulator to display the Options menu.</li>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 400
diff changeset 
    29
 
	<li>Choose the Message menu item and press the Select soft-key to send a message  (Figure 3).</li>
1490
811926adaf5e added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    30
 
	<p></p><p align="center"><img src="images/wnd_symbian_emulator_02.png" alt="Menu selection" width="378" height="431"></p>
811926adaf5e added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    31
 
  <p class="figure">Figure 3 - Send Message to OortCloud application </p>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 400
diff changeset 
    32
 
  <p>The <span class="code">HandleCommandL</span> breakpoint  is hit in the program and control returns to the Carbide debugger (Figure 4). You can now set additional breakpoints, examine variables, or use the <a href="../../debugger/debug/viewing_debug.htm">Debug</a> view buttons to control the program. </p>
1490
811926adaf5e added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    33
 
  <p align="center"><img src="images/wnd_symbian_emulator_03.png" alt="Breakpoint hit" width="678" height="281"></p>
811926adaf5e added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset 
    34
 
  <p class="figure">Figure 4 - Back in the COortCloudAppUI::HandleCommandL routine</p>
400
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    35
 
  </ol>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    36
 
  <p>That's it for this basic introduction to debugging with Carbide.c++.</p>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    37
 
</div>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    38
 
<h5>Concepts</h5>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    39
 
  <ul>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    40
 
    <li><a href="../../concepts/Projects.html">Projects</a></li>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    41
 
</ul>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    42
 
  <h5>Tasks</h5>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    43
 
  <ul>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    44
 
    <li><a href="../CreatingNewProjects.html">Creating Projects</a></li>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    45
 
    <li><a href="../projects/prj_build.htm">Building Projects</a></li>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    46
 
    <li><a href="../projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    47
 
  </ul>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 400
diff changeset 
    48
 
  <div id="footer">Copyright &copy; 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
400
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset 
    49
 












9b005a8e6778
removed duplicate pages, unused images, and fixed links to same



fturovic <frank.turovich@nokia.com>


parents: 
0

diff
changeset




    50


</body>








0






fb279309251b
DP tools release version Revision: 200912



Deepak Modgil <Deepak.Modgil@Nokia.com>


parents: 

diff
changeset




    51


</html>














FCL/sftools/dev/ide/carbidecpp