author | fturovic <frank.turovich@nokia.com> |
Thu, 25 Feb 2010 14:29:57 -0600 | |
branch | RCL_2_4 |
changeset 1028 | 2bae15d3b247 |
parent 995 | daded633d00d |
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.01 Transitional//EN" |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
2 |
"http://www.w3.org/TR/html4/loose.dtd"> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
3 |
<html> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
4 |
<head> |
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-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
|
6 |
<title>Launch Configuration Overview</title> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
7 |
<link href="../../../book.css" rel="stylesheet" type="text/css"></head> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
8 |
|
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
9 |
<body> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
10 |
<h2>Launch Configuration Overview</h2> |
1028
2bae15d3b247
updated icons and launch page content
fturovic <frank.turovich@nokia.com>
parents:
995
diff
changeset
|
11 |
<p>A <b>launch configuration</b> defines the operational settings used by the Carbide.c++ tools to launch and debug programs. A project must have at least one launch configuration, and can have as many as necessary. This enables you to develop and debug your project using various compilers (GCCE and RVCT) and different targets (emulator, on-device, and reference boards) as each launch configuration can be tailored to fit the intended target. </p> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
12 |
<h4>Creating a Launch Configuration </h4> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
13 |
<p>To create a default launch configuration for a project use the <a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a>. Using this method ensures that you have a working launch configuration for the project. You can invoke the New Launch Configuration Wizard for projects lacking a launch configuration by selecting the <b>Run > Debug</b> (<span class="code">F11</span>) or<b> </b><b>Run > Run</b> (<span class="code">CTRL+F11</span>) menu options, or clicking the <b>Run</b> (<img src="../../images/icons/btn_run.png" alt="Run icon" width="16" height="16" align="absmiddle" />) or <b>Debug</b> (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle" alt="Debug icon"/>) icons in the toolbar. If a project already has a defined launch configuration, selecting the <b>Run</b> or <b>Debug</b> command calls the previously defined and last used launch configuration, bypassing the wizard entirely.</p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
14 |
<p>For emulator projects the wizard simply gathers the data it needs from the project and creates an emulator launch configuration and launches the emulator. For on-device targets, more information is required, so the wizard asks for the missing information it needs, creates the launch configuration, then downloads the executable to the device and launches it. Once the emulator or device is loaded with the executable, the debug session commences. </p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
15 |
<p>You can customize any project launch configuration afterward using the <b>Debug</b> dialog as necessary. </p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
16 |
<h4>Available Launch Configurations</h4> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
17 |
<p>Launch configurations come in several varieties, each designed for a specific purpose. You must choose one at the very start of the New Launch Configuration Wizard, so knowing the differences between them is important. Currently, the types to choose from include: </p> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
18 |
<ul> |
995
daded633d00d
minor editorial revisions
fturovic <frank.turovich@nokia.com>
parents:
817
diff
changeset
|
19 |
<li><b><a href="applications.htm">Symbian OS Application</a></b> — used to run or debug executables. </li> |
daded633d00d
minor editorial revisions
fturovic <frank.turovich@nokia.com>
parents:
817
diff
changeset
|
20 |
<li><b><a href="run_mode.htm">Symbian OS Appication TRK</a></b> — used to run or debug applications on a target device using the Application TRK on-device debug agent. Application TRK is an application that runs on released phones and allows you to debug your executables. The debugger will download a Symbian OS installation file to the phone and install it prior to launching.</li> |
daded633d00d
minor editorial revisions
fturovic <frank.turovich@nokia.com>
parents:
817
diff
changeset
|
21 |
<li><b><a href="attach_process.htm">Symbian OS Attach to Process</a></b> — used to debug processes running on a target device for which a symbol file is available. This is available only for TRK and stop mode debugging. This launch configuration is not available for emulator debugging. Stop mode and TRK can both attach to a process from the <a href="../../reference/view_symbian_kernel.htm">Symbian OS Data</a> view.</li> |
daded633d00d
minor editorial revisions
fturovic <frank.turovich@nokia.com>
parents:
817
diff
changeset
|
22 |
<li><b><a href="PLUGINS_ROOT/com.nokia.carbide.cpp.debug.crashdebugger/html/view.html">Symbian OS Crash Debugger</a></b> — used to launch an interactive command-line session with the Symbian OS crash debugger when the device crashes </li> |
daded633d00d
minor editorial revisions
fturovic <frank.turovich@nokia.com>
parents:
817
diff
changeset
|
23 |
<li><b><a href="emulation.htm">Symbian OS Emulation</a> </b>— used to run or debug executables on an emulator. </li> |
daded633d00d
minor editorial revisions
fturovic <frank.turovich@nokia.com>
parents:
817
diff
changeset
|
24 |
<li><b><a href="stop_mode.htm">Symbian OS System TRK</a></b> — used to run or debug applications or ROM code on a target device using the System TRK on-device debug agent. System TRK is an application that runs on reference boards and prototype phones and allows you to debug your executables. The debugger will download files to the phone prior to launching.</li> |
daded633d00d
minor editorial revisions
fturovic <frank.turovich@nokia.com>
parents:
817
diff
changeset
|
25 |
<li><b><a href="trace32.htm">Symbian OS Trace32</a></b> — is an external debugger that the Carbide debugger communicates with, to debug any Symbian OS module on a target using a JTAG connection.</li> |
400
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
26 |
</ul> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
27 |
<h4>Other references</h4> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
28 |
<ul> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
29 |
<li>Creating Projects Overview </li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
30 |
<li><a href="wiz_new_launch_config.htm">New Launch Configuration Wizard</a></li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
31 |
<li><a href="wnd_debug_configuration.htm">Debug</a> dialog </li> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
32 |
</ul> |
817
41b05da1d19f
BUG 10603 - pulled sophia text references from manual, some images may still contain references
fturovic <frank.turovich@nokia.com>
parents:
400
diff
changeset
|
33 |
<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
|
34 |
</body> |
9b005a8e6778
removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
35 |
</html> |