author | fturovic <frank.turovich@nokia.com> |
Wed, 06 Oct 2010 10:31:32 -0500 | |
changeset 2131 | ff0156b93599 |
parent 2120 | dbf5f2de7750 |
permissions | -rw-r--r-- |
264
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
2 |
<html> |
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
3 |
<head> |
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
4 |
<meta http-equiv="Content-Type" |
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
5 |
content="text/html; charset=ISO-8859-1" /> |
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
6 |
<meta http-equiv="Content-Style-Type" content="text/css" /> |
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
7 |
<meta name="LASTUPDATED" content="06/17/05 11:09:43" /> |
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
8 |
<title>New Launch Configuration Wizard</title> |
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
9 |
<link rel="StyleSheet" href="../../../book.css" type="text/css" /> |
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
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:
1754
diff
changeset
|
11 |
<body > |
264
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
12 |
<h2>New Launch Configuration Wizard </h2> |
2131
ff0156b93599
moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
2120
diff
changeset
|
13 |
<p>The <b>New Launch Configuration Wizard</b> launches when no launch configuration exists for a build configuration in a project. Wherever possible the <b>New Launch Configuration </b> wizard gathers the information from the project and asks additional questions based on the type of launch configuration chosen. For example, a launch configuration using Symbian Device (Install SIS) requires different information than one targeted for Symbian Device. </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
|
14 |
<p>Every project consists of one or more build configurations as listed under the <b>Build project</b> icon (<img src="../images/icon_build_project.png" alt="Build project icon" width="17" height="17" align="absmiddle">) of the toolbar or in the <a href="../../tasks/projects/prj_new_build_config.htm">Add/Remove Carbide Build Configuration</a> dialog. Every build configuration needs a launch configuration to enable debugging. Launch configurations can be shared between build configurations. The <b>New Launch Configuration Wizard</b> detects when a build configuration doesn't have an associated launch configuration and guides you through the setup process.</p> |
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
|
15 |
<p align="center"><img src="images/menu_build_target.png" width="428" height="224"></p> |
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
|
16 |
<p class="figure">Figure 1. Build configurations for the chosen project appear under the Build icon</p> |
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
|
17 |
<p>To access the <b>New Launch Configuration Wizard</b> click the <b>Debug</b> icon (<img src="../../projects/images/icon_debug.png" alt="" width="17" height="16" align="absmiddle">) on the toolbar. If no launch configuration exists for the selected build target the wizard is launched. If a launch configuration already exists, then that launch configuration is launched and not the wizard.</p> |
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
|
18 |
<h2>Launch Configuration Wizard Pages</h2> |
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
|
19 |
<p>The following are the possible pages you will see depending upon your choice of build configuration and type of debugging required. Different launch configurations need different information to work properly. The following table lists all the pages seen when choosing common types of debugging.</p> |
264
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
20 |
<table width="700" border="0" cellpadding="2" cellspacing="0"> |
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
|
21 |
<tr> |
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
|
22 |
<th width="41%" scope="col">Launch Configuration</th> |
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
|
23 |
<th width="59%" scope="col">Wizard Pages</th> |
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
|
24 |
</tr> |
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 |
<tr> |
2120
dbf5f2de7750
removed old launch config images and revised page to remove same
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
26 |
<td><b>Device</b></td> |
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
|
27 |
<td><ul> |
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
|
28 |
<li><a href="#DEBUGAS">Debug As</a></li> |
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
|
29 |
<li><a href="#EXE_SEL">Executable Selection</a></li> |
2120
dbf5f2de7750
removed old launch config images and revised page to remove same
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
30 |
<li><a href="#BLD_OPT">Build Options Selection</a></li> |
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
|
31 |
<li><a href="#FINISH">New Launch Configuration</a></li> |
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
|
32 |
</ul></td> |
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
|
33 |
</tr> |
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
|
34 |
<tr> |
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
|
35 |
<td><b>Simulator</b></td> |
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
|
36 |
<td><ul> |
2120
dbf5f2de7750
removed old launch config images and revised page to remove same
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
37 |
<li><a href="#DEBUGAS">Debug As</a><a href="#EXE_SEL"></a></li> |
dbf5f2de7750
removed old launch config images and revised page to remove same
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
38 |
<li><a href="wnd_config_launch_config.htm">Configure launch configuration</a></li> |
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
|
39 |
</ul></td> |
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
|
40 |
</tr> |
264
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
41 |
</table> |
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
|
42 |
<h3><a name="DEBUGAS" id="LAUNCH2"></a>Debug As</h3> |
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
|
43 |
<p>Use the<b> Debug As </b>dialog to select the method of debugging for the chosen build configuration. The choices include: </p> |
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
|
44 |
<ul> |
2120
dbf5f2de7750
removed old launch config images and revised page to remove same
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
45 |
<li><b>Device</b> – debug on Symbian devices using CODA (Carbide On-device Debug Agent) </li> |
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
|
46 |
</ul> |
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
|
47 |
<ul> |
2120
dbf5f2de7750
removed old launch config images and revised page to remove same
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
48 |
<li><b>Simulator</b> – debug on Symbian simulators</li> |
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
|
49 |
</ul> |
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
|
50 |
<p>The choice made here filters the <b>Launch Types</b> page to only show valid launch configurations. Once a debug as choice is made, click <b>OK</b>. </p> |
2120
dbf5f2de7750
removed old launch config images and revised page to remove same
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
51 |
<p align="center"><img src="images/wiz_launch_config_debug_as.png" alt="Debug As dialog" width="350" height="350"></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
|
52 |
<p class="figure">Figure 1 - Debug As dialog </p> |
2120
dbf5f2de7750
removed old launch config images and revised page to remove same
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
53 |
<h3><a name="BLD_OPT" id="EXE_SEL2"></a>Build Options Selection page</h3> |
345
9d9aecf552ee
[bug 9352] added emulation item, removed outdated paragraph, and converted auto to automatic
fturovic <frank.turovich@nokia.com>
parents:
279
diff
changeset
|
54 |
<p>Use the <b>Build Options Selection </b> page to define if the launch configuration uses automatic build or not. Choices include using the global automatic built setting (default), enable or disable automatic build for the launch configuration. You can also set the global option using the Configure Workspace Settings... to open the Launching preference panel.</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
|
55 |
<p align="center"><img src="images/wiz_launch_config_build_options.png" width="631" height="433"></p> |
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
|
56 |
<p class="figure">Figure 3 - Build Options Selection page </p> |
2120
dbf5f2de7750
removed old launch config images and revised page to remove same
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
57 |
<h3><a name="EXE_SEL" id="EXE_SEL"></a>Executable Selection page</h3> |
dbf5f2de7750
removed old launch config images and revised page to remove same
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
58 |
<p>Use the <b>Executable Selection </b> page to choose a binary created by the project to launch and debug. If only a single binary is available the <b>Process to launch</b> option is disabled. </p> |
264
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
59 |
<p><b>EMULATOR ONLY</b> Use the <b>Location</b> field for emulator targets to verify that the correct executable on the host is selected. This field is not used with on-device launch configurations. </p> |
2087
617a89f9dffc
BUG 12110 - text instances of apptrk/systrk changed, more images yet to update
fturovic <frank.turovich@nokia.com>
parents:
2009
diff
changeset
|
60 |
<p>Select the <b>Process to launch</b>, verify it is the correct binary. </p> |
2120
dbf5f2de7750
removed old launch config images and revised page to remove same
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
61 |
<p>Use the <b>Specify device path of remote process to launch</b> option (<i>not shown</i>) to specify alternate paths for launching the executable from RAM (<span class="code">c:\sys\bin\</span>), ROM (<span class="code">z:\sys\bin\</span>) or memory cards (<span class="code">e:\sys\bin\</span>), then click <b>Next</b>. </p> |
dbf5f2de7750
removed old launch config images and revised page to remove same
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
62 |
<p align="center"><img src="images/wiz_launch_config_app_selection.png" width="542" height="421"> </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
|
63 |
<p class="figure">Figure 4 - Executable Selection page (when project has multiple EXEs)</p> |
264
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
64 |
<h3><a name="FINISH" id="FINISH"></a>New Launch Configuration</h3> |
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
65 |
<p>Use the <b>New Launch Configuration</b> page to note the name of the configuration, confirm the launch configuration settings, and then launch the debug session. If something doesn't look right, click <b>Back</b> to return to a page and change its setting. If all the settings are correct, click <b>Finish</b> to start the debug session using this launch configuration. </p> |
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
66 |
<p>If you checkmark <b> Advanced settings</b>, the <a href="../../reference/wnd_debug_configuration.htm">Debug</a> dialog appears instead of launching the project. This enables you to make additional changes to the new launch configuration before starting the debug session. By design and intent, this should seldom be required for the initial launch. </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
|
67 |
<p align="center"><img src="images/wiz_launch_new_launch_config.png" alt="New Launch Configuration dialog" width="631" height="433"></p> |
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
|
68 |
<p class="figure">Figure 7 - New Launch Configuration page </p> |
264
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
69 |
<h5>Other references</h5> |
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
70 |
<ul> |
2120
dbf5f2de7750
removed old launch config images and revised page to remove same
fturovic <frank.turovich@nokia.com>
parents:
2087
diff
changeset
|
71 |
<li><a href="../../projects/launch/launch_configs_overview.htm">Launch Configuration</a></li> |
264
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
72 |
</ul> |
819
8121a281245c
BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents:
400
diff
changeset
|
73 |
<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> |
264
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
74 |
|
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
75 |
</body> |
c8bd296c5b92
moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff
changeset
|
76 |
</html> |