author | fturovic <frank.turovich@nokia.com> |
Wed, 06 Oct 2010 10:31:32 -0500 | |
changeset 2131 | ff0156b93599 |
parent 2092 | 047b263f1004 |
child 2136 | f0b706fa897d |
permissions | -rw-r--r-- |
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>Run Mode Debug Example</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 |
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
10 |
</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
|
11 |
<body > |
2131
ff0156b93599
moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
2092
diff
changeset
|
12 |
<h2>Run Mode Debug Example (Symbian Device (Install SIS)) </h2> |
ff0156b93599
moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
2092
diff
changeset
|
13 |
<p>This example shows how to create and build an application and debug it on a device using the Symbian Device (Install SIS) on-device debug agent. The majority of steps are identical to the ones used to create a program and debug in an emulator, with some minor variations.</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:
2092
diff
changeset
|
15 |
<h4>Debugging a Run-mode Project using Symbian Device (Install SIS) </h4> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
16 |
<ol> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
17 |
<li>Import the Bld.inf to create a project using the Import wizard </li> |
1490
811926adaf5e
added new images for emulator example
fturovic <frank.turovich@nokia.com>
parents:
1376
diff
changeset
|
18 |
<p>In this example we are importing a project called Music, a complex project that includes several EXEs (MusicPlayer, MusicShop, MusicVisualizer). For the import, we select an ARM target.</p> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
19 |
<li>Go to the project Properties page and in the Carbide Build Configuration panel specify the PKG file in the <a href="../../reference/build_properties/pane_build_config_sis.htm">SIS Builder</a> tab </li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
20 |
<li>Build the project (Ctrl+B) </li> |
2131
ff0156b93599
moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
2092
diff
changeset
|
21 |
<li>Verify that all the binaries built by the project appear in the <a href="../../projects/views/view_executables.htm">Executables</a> view. </li> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
22 |
<p class="note"><b>NOTE</b> The symbolics are automatically loaded for the binaries that appear in the Executables view.</p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
23 |
<li>Set <a href="../breakpoints/pgm_bp_setting.htm">breakpoints</a> in the project source files </li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
24 |
<p>In this example we will set one breakpoint in two different EXEs. The first is set in the file called <span class="code">MCEngine.cpp</span> (MCServer.exe) and the second is set in <span class="code">MPlayerAppUI.cpp</span> (MusicPlayer.exe). </p> |
1933
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
1791
diff
changeset
|
25 |
<li>Click the Debug icon (<img src="../../projects/images/icon_debug.png" width="17" height="16" align="absmiddle">) to launch the <a href="../../projects/launch/wiz_new_launch_config.htm">New Launch Configuration</a> wizard |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
26 |
<ol type="a"> |
2131
ff0156b93599
moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
2092
diff
changeset
|
27 |
<li>Select the Symbian Device (Install SIS) Launch Configuration from the Launch Types page, then click Next</li> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
28 |
<p align="center"><img src="../trk/images/trk_launch_types.png" width="438" height="533"></p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
29 |
<p class="figure">Figure 1 - Launch Types page showing selection </p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
30 |
<li>If you have more than one executable, select the Main Executable in the Executable Selection page of the wizard, then click Next</li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
31 |
<p>For this example we select the musicplayer.exe as the main executable.</p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
32 |
<p align="center"><img src="../trk/images/trk_exe_selection.png" width="438" height="533"></p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
33 |
<p class="figure">Figure 2 - Executable Selection page showing selection </p> |
2092
047b263f1004
more trk to coda changes
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
34 |
<li>Select the remote connection to use in CODA Connection Settings page, then click Next</li> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
35 |
<p align="center"><img src="../trk/images/trk_conn_settings.png" width="438" height="533"></p> |
2009
b622387629d6
changed TRK to CODA in docs except where it related to pre-3.0 versions
fturovic <frank.turovich@nokia.com>
parents:
1933
diff
changeset
|
36 |
<p class="figure">Figure 3 - CODA Connection Settings page showing selection </p> |
2092
047b263f1004
more trk to coda changes
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
37 |
<li>Select the SIS file to install in CODA SIS Selection page if not already populated</li> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
38 |
</ol> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
39 |
<blockquote> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
40 |
<p class="figure"><img src="../trk/images/trk_sis_selection.png" width="438" height="533"></p> |
2009
b622387629d6
changed TRK to CODA in docs except where it related to pre-3.0 versions
fturovic <frank.turovich@nokia.com>
parents:
1933
diff
changeset
|
41 |
<p class="figure">Figure 4 - CODA Connection Settings page showing selection </p> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
42 |
</blockquote> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
43 |
<ol type="a"> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
44 |
<li>Click Finish </li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
45 |
<br> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
46 |
<p>The SISX file is downloaded and authenticated, then the binaries are installed automatically on the phone. </p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
47 |
</ol> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
48 |
<li>Once the debug session launches, control returns to the Debugger when one of the breakpoints set earlier is hit. </li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
49 |
<p>At this point you can debug the program in the Debug perspective. Look at the <a href="../../reference/view_breakpoints.htm">Breakpoints</a> view to verify that the breakpoints set earlier are resolved. In this case, the breakpoint in the MCServer.exe.</p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
50 |
<p align="center"><img src="../trk/images/trk_debug_perspective_dll.png" width="902" height="629"></p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
51 |
<p class="figure">Figure 5 - Debug perspective showing the resolved breakpoint </p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
52 |
<li>Click Resume in the Debug view to hit the breakpoint set in the second EXE</li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
53 |
<p align="center"><img src="../trk/images/trk_debug_perspective_exe.png" width="902" height="629"></p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
54 |
<p class="figure">Figure 6 - Debug perspective showing the resolved EXE breakpoint </p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
55 |
<li>In the Debug view |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
56 |
<ol type="a"> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
57 |
<li>Click <a href="../../debugger/debug/cmds_other.htm">Disconnect</a> to leave the application running on the device, OR </li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
58 |
<li>Click <a href="../../debugger/debug/cmds_starting.htm">Terminate</a> to stop the application running on the device</li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
59 |
</ol> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
60 |
</li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
61 |
</ol> |
2131
ff0156b93599
moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
2092
diff
changeset
|
62 |
<p>In addition, you can click the <a href="../../reference/view_symbian_kernel.htm">Symbian Data View</a> to examine the processes running on the devise during the debug session. </p> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
63 |
</div> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
64 |
<h5>Related references</h5> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
65 |
<ul> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
66 |
<li><a href="../trk/trk_troubleshooting.htm">On-device Debugging Troubleshooting</a></li> |
2131
ff0156b93599
moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
2092
diff
changeset
|
67 |
<li><a href="../../reference/view_symbian_kernel.htm">Symbian View</a></li> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
68 |
</ul> |
1376
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
400
diff
changeset
|
69 |
<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> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
70 |
|
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
71 |
</body> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
72 |
</html> |