--- a/core/com.nokia.carbide.cpp.doc.user/html/tasks/start/carbide_debugging.htm Wed Feb 10 13:54:04 2010 -0600
+++ b/core/com.nokia.carbide.cpp.doc.user/html/tasks/start/carbide_debugging.htm Wed Feb 10 14:36:43 2010 -0600
@@ -10,38 +10,28 @@
<body bgcolor="#FFFFFF">
<h2>Debugging a Symbian OS Program</h2>
<p>Use the Carbide.c++ debugger to debug a compiled Symbian OS program in an emulator or on-device. The same process works for other emulators and target devices as well.</p>
-<p class="note"><b>NOTE</b> This example uses an emulator. The steps are identical for on-device debugging, although a .sym file is not needed for emulator builds.</p>
+<p class="note"><b>NOTE</b> This example uses the emulator included with the S60 5th Edition SDK. The steps are identical for on-device debugging, although a <span class="code">.sym</span> file is not needed for emulator builds.</p>
<div class="step">
<h4>Debugging a Symbian OS program</h4>
-<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. You will also need a symbolics ( .sym) file for debugging on a target device. Ensure that a .sym file has been created. If you are importing an existing application, you may have to rebuild the application and create a related .sym file. Make sure a .sym file has been created in the output directory.</p>
+<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>
<ol>
- <li>Set a breakpoint in the HelloCarbide program</li>
- <p>Open the <span class="code">\src\CHelloCarbideAppUI.cpp</span> file and <a href="../breakpoints/pgm_bp_setting.htm">set a breakpoint</a> in the <span class="code">HandleCommandL</span> routine.</p>
- <p align="center"><img src="images/debug_set_breakpoint.png" width="602" height="238" /></p>
- <p class="figure">Figure 1 - Breakpoint set in <span class="code">CHelloCarbideAppUI</span>::HandleCommandL routine. </p>
- <li>Launch the Carbide.c++ debugger and S60 EPOC Emulator</li>
- <p><a href="../../debugger/debug/cmds_starting.htm">Start</a> the Carbide debugger which launches the S60 EPOC Emulator and installs the HelloCarbide application. For on-device debugging, the application is installed on the target device.</p>
- <p align="center"><img src="images/debug_s60_emulator_launch.png" width="293" height="391" /></p>
- <p class="figure"><span class="figure">Figure 2 - S60 Emulator launches</span></p>
- <li>Open the Installed directory within the S60 Emulator or your target device </li>
- Use the S60 Emulator controls to locate and open the Installation directory. Select Open from the Options menu (Figure 3).
- <p align="center"><img src="images/debug_s60_emulator_02.png" width="352" height="168" /></p>
- <p class="figure">Figure 3 - Open the Installed directory </p>
- <li>Launch the HelloCarbide application</li>
- <p>Use the S60 Emulator or target device controls to launch the HelloCarbide application (Figure 4).
- </p>
- <p align="center"><img src="images/debug_s60_emulator_03.png" width="122" height="106" /></p>
- <p class="figure">Figure 4 - Launch the HelloCarbide application </p>
- <p>The HelloCarbide application launches (Figure 5). </p>
- <p align="center"><img src="images/debug_s60_emulator_04.png" width="293" height="391" /></p>
- <p class="figure">Figure 5 - HelloCarbide application running on S60 Emulator </p>
- <li>Click the Options soft-key on the S60 Emulator to display the Select menu.</li>
- <li>Choose the Message menu item and press the Select soft-key to send a message (Figure 6).</li>
- <p></p><p align="center"><img src="images/debug_s60_emulator_05.png" width="384" height="254" /></p>
- <p class="figure">Figure 6 - Send Message to HelloCarbide application </p>
- <p>The <span class="code">HandleCommandL</span> breakpoint is hit in the program and control returns to the Carbide.c++ debugger (Figure 7). You can now set additional breakpoints, examine variables, or use the<a href="../../debugger/debug/viewing_debug.htm"> Debug view</a> buttons to control the program. </p>
- <p align="center"><img src="images/debug_s60_emulator_06.png" width="602" height="238" /></p>
- <p class="figure">Figure 7 - Back in the CHelloCarbideAppUI::HandleCommandL routine</p>
+ <li>Set a breakpoint in the MyProject program</li>
+ <p>Open the <span class="code">\src\MyProjectAppUI.cpp</span> file and <a href="../breakpoints/pgm_bp_setting.htm">set a breakpoint</a> in the <span class="code">HandleCommandL</span> routine.</p>
+ <p align="center"><img src="images/debug_set_breakpoint.png" width="707" height="253" /></p>
+ <p class="figure">Figure 1 - Breakpoint set in MyProjectAppUI::HandleCommandL routine. </p>
+ <li>Launch the Carbide debugger and S60 SDK Emulator</li>
+ <p><a href="../../debugger/debug/cmds_starting.htm">Start</a> the Carbide debugger which launches the S60 SDK Emulator, installs and launches the executable. For on-device debugging, the application is installed on the target device.</p>
+ <p>The HelloCarbide application launches (Figure 2). </p>
+ <p align="center"><img src="images/debug_s60_emulator_04.png" width="465" height="811" /></p>
+ <p class="figure">Figure 2 - MyProject application running on S60 Emulator </p>
+ <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>
+ <li>Click the Options soft-key on the S60 Emulator to display the Options menu.</li>
+ <li>Choose the Message menu item and press the Select soft-key to send a message (Figure 3).</li>
+ <p></p><p align="center"><img src="images/debug_s60_emulator_05.png" width="465" height="458" /></p>
+ <p class="figure">Figure 3 - Send Message to MyProject application </p>
+ <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>
+ <p align="center"><img src="images/debug_s60_emulator_06.png" width="686" height="276" /></p>
+ <p class="figure">Figure 4 - Back in the CMyProjectAppUI::HandleCommandL routine</p>
</ol>
<p>That's it for this basic introduction to debugging with Carbide.c++.</p>
</div>
@@ -55,7 +45,7 @@
<li><a href="../projects/prj_build.htm">Building Projects</a></li>
<li><a href="../projects/prj_debug_config.htm">Creating a Launch Configuration</a></li>
</ul>
- <div id="footer">Copyright © 2009 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>
+ <div id="footer">Copyright © 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>
</body>
</html>
\ No newline at end of file
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/start/images/debug_s60_emulator_04.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/start/images/debug_s60_emulator_05.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/start/images/debug_s60_emulator_06.png has changed
Binary file core/com.nokia.carbide.cpp.doc.user/html/tasks/start/images/debug_set_breakpoint.png has changed
