author | stechong |
Wed, 20 Oct 2010 11:19:31 -0500 | |
changeset 2165 | 2a7b5eccb0bc |
parent 2131 | ff0156b93599 |
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" |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
5 |
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
|
6 |
<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
|
7 |
<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
|
8 |
<title>Creating a Launch Configuration</title> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
9 |
<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
|
10 |
</head> |
1791
727385d8e2b3
added new customize carbide section and some relinking done for deleted duplicate page
fturovic <frank.turovich@nokia.com>
parents:
1610
diff
changeset
|
11 |
<body > |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
12 |
<h2>Creating a Launch Configuration</h2> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
13 |
<p>To run or debug a project you need a <a href="../../projects/launch/launch_configs_overview.htm">launch configuration</a>. A project must have at least one launch configuration, and can have as many as necessary. When run on an emulator project the wizard simply creates an emulator launch configuration and launches the emulator. When running a device project for the first time the <a href="../../projects/launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> seeks additional information required to create the launch configuration, then downloads the executable to the device and launches it. Once the emulator or device are loaded with the executable, the debug session can commence. </p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
14 |
<p>There are two methods for setting up a launch configuration, including:</p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
15 |
<ul> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
16 |
<li><b>Default launch configuration</b>— automatically sets up a default launch configuration to run or debug the project on the first Run or Debug execution. This provides a quick and easy method to start running or debugging a new project without the hassle of setting a lot of options. The default launch configuration can always be edited later as the project launch requirements change.</li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
17 |
<li><b>Custom launch configuration</b>— enables you to setup a custom launch configuration to debug the project</li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
18 |
</ul> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
19 |
<div class="step"> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
20 |
<h4>Creating a Default Launch Configuration</h4> |
1207
e265bbe56eb0
merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents:
400
diff
changeset
|
21 |
<p class="note"><b>NOTE</b> Carbide only creates a new default launch configuration when it cannot find one in the project. If the project already contains a launch configuration, Carbide launches that instead. </p> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
22 |
<ul> |
1933
a77f12f0a631
BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents:
1835
diff
changeset
|
23 |
<li>Click the <b>Run</b> (<img src="../../images/icons/btn_run.png" alt="Run icon" width="16" height="16" align="middle" />) or <b>Debug</b> (<img src="../../projects/images/icon_debug.png" width="17" height="16" align="middle" alt="Debug icon"/>) icon in the tool bar |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
24 |
<p>or</p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
25 |
</li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
26 |
<li>Choose Select <b>Run > Run</b> menu option to launch the project or <b>Run > Debug</b> menu option to debug the project</li> |
1207
e265bbe56eb0
merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents:
400
diff
changeset
|
27 |
<p>Carbide creates a default launch configuration for the project that is used to run or debug the project. If the project already has a defined launch configuration, clicking <b>Run</b> or <b>Debug</b> uses it instead of creating a new one. There are two possible scenarios when creating a default launch configuration: </p> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
28 |
<ul> |
1207
e265bbe56eb0
merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents:
400
diff
changeset
|
29 |
<li><b>for emulator targets</b> <b> - an emulator launch configuration is created based on the project settings </b></li> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
30 |
<li><b>for target devices</b> - the <a href="../../projects/launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> appears asking for additional information</li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
31 |
</ul> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
32 |
</ul> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
33 |
</div> |
1207
e265bbe56eb0
merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents:
400
diff
changeset
|
34 |
<p class="note"><b>NOTE</b> To see if a project already has a launch configuration, open a Run or Debug window using the <b>Run > Run As</b> or <b>Run > Debug As</b> menu items. </p> |
e265bbe56eb0
merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents:
400
diff
changeset
|
35 |
<p>In the event that the default launch configuration settings must be changed, edit them in the <a href="../../reference/wnd_debug_configuration.htm">Debug</a> window, or simply create a new launch configuration for the project that deviates from the default settings.</p> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
36 |
<div class="step"> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
37 |
<h4>Creating a Custom Launch Configuration </h4> |
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 |
<li>Open the Run or Debug launch configuration window |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
40 |
<ul> |
1207
e265bbe56eb0
merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents:
400
diff
changeset
|
41 |
<li>Select the Run> <b>Run As</b> or <b>Run > Debug As </b> menu item |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
42 |
<p>The appropriate Run or <a href="../../reference/wnd_debug_configuration.htm">Debug</a> launch configuration window appears (Figure 1).</p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
43 |
</li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
44 |
</ul> |
1610
5e244b89116e
revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
1207
diff
changeset
|
45 |
<p align="center"><img src="images/wnd_launch_configuration_blank.png" width="709" height="455" alt="Undefined launch configuration"/> </p> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
46 |
<p class="figure">Figure 1 - Initial blank Debug launch configuration window</p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
47 |
</li> |
2131
ff0156b93599
moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
1933
diff
changeset
|
48 |
<li>Select a type of launch configuration (for example, Symbian Emulation), then click the New launch configuration icon to create a new |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
49 |
configuration of that type. |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
50 |
<p>A new configuration appears in the Configuration list under the |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
51 |
appropriate section using the project name and target to create the configuration name.</p> |
1207
e265bbe56eb0
merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents:
400
diff
changeset
|
52 |
<p class="note"><b>NOTE</b> Project information is used to fill in the <b>Project</b> and <b>Process to launch</b> text boxes by default when you click <b>New</b>. You should not have to edit these for a normal run/debug project. If a <span class="code">bld.inf</span> has multiple MMP files listed, then the first executable in the list is used to fill in the executable field. Therefore, for projects with multiple MMPs you may need to change the executable field. </p> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
53 |
</li> |
1610
5e244b89116e
revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
1207
diff
changeset
|
54 |
<p align="center"><img src="images/run_config_new.png" width="787" height="489" alt="New launch configuration" /> </p> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
55 |
<p class="figure">Figure 2 - New launch configuration with name and settings filled in (emulator)</p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
56 |
|
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
57 |
<li>View the information to define the project and executable |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
58 |
<p>Modify or fill in the following fields in the Main tab so the IDE |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
59 |
can setup the configuration properly each time. Typically when creating |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
60 |
a new executable from a project that has successfully linked, the |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
61 |
fields will be auto-populated and do not need to be modified. The important fields here are:</p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
62 |
<ul> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
63 |
<li>Name - <span style="font-weight: normal;">This is a unique name to identify this debug launch configuration. It can be any name.</span> </li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
64 |
<li>Project - <span style="font-weight: normal;">The project to associate with this debug launch configuration. Click Browse to select a different project.</span></li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
65 |
<li>Process to launch - <span style="font-weight: normal;">This is the name of the executable that is linked to the project.</span></li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
66 |
</ul> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
67 |
</li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
68 |
|
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
69 |
<li>Modify settings in the other Carbide tabs to customize the launch configuration |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
70 |
for the project |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
71 |
<ul> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
72 |
<li>Environment (<i>Eclipse</i>) </li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
73 |
<li><a href="../../projects/launch/page_debugger.htm">Debugger</a></li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
74 |
<li><a href="../../projects/launch/page_executables.htm">Executables</a></li> |
1835
113f8e9d5cb6
added new exceptions page for stop mode and related images
fturovic <frank.turovich@nokia.com>
parents:
1791
diff
changeset
|
75 |
<li><a href="../../projects/launch/page_x86_exceptions.htm">x86 Exceptions</a> </li> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
76 |
<li>Arguments (<i>Eclipse</i>) </li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
77 |
<li>Source (<i>Eclipse</i>) </li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
78 |
<li>Common (<i>Eclipse</i>) </li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
79 |
</ul> |
2131
ff0156b93599
moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents:
1933
diff
changeset
|
80 |
<p>To debug something outside of the workspace, be sure to import the binary into the <a href="../../projects/views/view_executables.htm">Executables</a> view. </p> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
81 |
</li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
82 |
<li>Click Debug |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
83 |
<p>The IDE launches the executable. If the launch configuration is set to change perspective, it switches to the specified perspective. </p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
84 |
</li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
85 |
</ol> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
86 |
</div> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
87 |
<h5>Other references</h5> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
88 |
<ul> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
89 |
<li><a href="../../projects/launch/launch_configs_overview.htm">Launch Configurations</a> </li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
90 |
<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
|
91 |
<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
|
92 |
<li><a href="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
|
93 |
<li><a href="prj_debug_dlls.htm">Debugging DLLs</a></li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
94 |
</ul> |
1207
e265bbe56eb0
merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents:
400
diff
changeset
|
95 |
<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
|
96 |
|
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
97 |
</body> |
0
fb279309251b
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
98 |
</html> |