core/com.nokia.carbide.cpp.doc.user/html/projects/launch/launch_configs_overview.htm
author fturovic <frank.turovich@nokia.com>
Wed, 15 Sep 2010 09:40:16 -0500
changeset 2009 b622387629d6
parent 1933 a77f12f0a631
child 2087 617a89f9dffc
permissions -rw-r--r--
changed TRK to CODA in docs except where it related to pre-3.0 versions
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 819
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>
1933
a77f12f0a631 BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents: 1754
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 &gt; Debug</b> (<span class="code">F11</span>) or<b> </b><b>Run &gt; 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="../../projects/images/icon_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>
400
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>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 819
diff changeset
    19
  <li><b><a href="applications.htm">Symbian OS Application</a></b> &#8212; used to run or debug executables. </li>
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
    20
  <li><b><a href="run_mode.htm">Symbian OS Appication CODA</a></b> &#8212; used to run or debug applications on a target device using the Application CODA on-device debug agent. Application CODA 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>
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
    21
  <li><b><a href="attach_process.htm">Symbian OS Attach to Process</a></b> &#8212; used to debug processes running on a target device for which a symbol file is available. This is available only for CODA and stop mode debugging.  This launch configuration is not available for emulator debugging.  Stop mode and CODA can both attach to a process from the <a href="../../reference/view_symbian_kernel.htm">Symbian OS Data</a> view.</li>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 819
diff changeset
    22
  <li><b><a href="PLUGINS_ROOT/com.nokia.carbide.cpp.debug.crashdebugger/html/view.html">Symbian OS Crash Debugger</a></b> &#8212; used to launch an interactive command-line session with the Symbian OS crash debugger when the device crashes </li>
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 819
diff changeset
    23
  <li><b><a href="emulation.htm">Symbian OS Emulation</a> </b>&#8212; used to run or debug executables on an emulator. </li>
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
    24
  <li><b><a href="stop_mode.htm">Symbian OS System CODA</a></b> &#8212; used to run or debug applications or ROM code on a target device using the System CODA on-device debug agent. System CODA 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>
400
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    25
</ul>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    26
<h4>Other references</h4>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    27
<ul>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    28
  <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
    29
  <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
    30
  <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
    31
</ul>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 400
diff changeset
    32
<div id="footer">Copyright &copy; 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
    33
</body>
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    34
</html>