Mercurial Mercurial > oss > FCL > sftools > dev > ide > carbidecpp / annotate
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
core/com.nokia.carbide.cpp.doc.user/html/projects/tutorials/new_proj_from_template_03.htm
author fturovic <frank.turovich@nokia.com>
Wed, 14 Jul 2010 15:59:19 -0500
changeset 1617 94b6d1326534
parent 1610 5e244b89116e
child 1646 7bcb3d758005
permissions -rw-r--r--
revised dll example with new images, TOC, and welcome page
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1610
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     2
 
<html>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     3
 
<head>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     4
 
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     5
 
<meta http-equiv="Content-Style-Type" content="text/css" />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     6
 
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     7
 
<title>Defining a launch configuration</title>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     8
 
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
     9
 
</head>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    10
 
<body bgcolor="#FFFFFF">
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    11
 
<h2>Defining a launch configuration</h2>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    12
 
<p>In this example we show how to create a new project using one of the built-in Carbide templates, how to build it into an executable, and how to launch the debugger to verify program accuracy. The steps to do this include:</p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    13
 
<ol>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    14
 
    <li><a href="new_proj_from_template_01.htm">Creating</a> a project from a project template</li>
1617
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents: 1610
diff changeset 
    15
 
    <li><a href="new_proj_from_template_02.htm">Building</a> the object code based on the project sources</li>
1610
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    16
 
    <li><strong>Defining a launch configuration for running or debugging the application</strong></li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    17
 
    <li><a href="new_proj_from_template_04.htm">Controlling and debugging</a> the running program using  the Carbide debugger</li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    18
 
</ol>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    19
 
<hr>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    20
 
<p><strong></strong>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. It is not unusual to have two or more launch configurations per target device, usually a debug version and a run version. You can use the <a href="../../projects/launch/wiz_new_launch_config.htm">New Launch Configuration Wizard</a> to create them all.</p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    21
 
<ul>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    22
 
    <li>On emulator targets, the <strong>New Launch Configuration</strong> <strong>Wizard</strong> usually has all the information it requires to create a launch configuration and launch the program on the emulator. If at any time it needs additional information, dialogs will  ask for it, then launch the program.</li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    23
 
    <li>On device targets, the <strong>New Launch Configuration</strong> <strong>Wizard</strong>  requests all the additional information it needs like the target device, the remote connection, and more, before it creates the launch configuration. Once it has all the required data, it  creates the launch configuration, then downloads the executable to the device and launches it.</li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    24
 
</ul>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    25
 
<p>Once the emulator or device is loaded with the executable, a debug session  can begin. </p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    26
 
<p>If at any time the <strong>New Launch Configuration</strong> <strong>Wizard</strong> encounters a problem during a later launch sequence it will request settings clarification before continuing. For example, maybe the target device has changed, or a new ROM has been installed. Either of these will trigger a request for clarification.</p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    27
 
<div class="step">
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    28
 
    <h4>Defining a launch configuration (emulator example)</h4>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    29
 
    <ol>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    30
 
        <li>Select the project to run in the Project Explorer view.</li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    31
 
        <li>To run the project without the debugger choose:<br />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    32
 
        	<p>To simply run the project on the chosen target use one of the following actions. Use this option to verify a release program's execution without debugging symbols.</p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    33
 
        	<ol type="a">
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    34
 
                <li>Right-click the project and click Run As &gt; Run Symbian OS Application on Emulator.</li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    35
 
                <li>Click the Run &gt; Run (<span class="code">CTRL-F11</span>) menu item.</li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    36
 
                <li>Click the Run (<img src="../images/icon_run.png" alt="Run icon" width="16" height="16" align="absmiddle">) icon in the toolbar.</li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    37
 
            </ol>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    38
 
        </li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    39
 
        <li>Select the Process to launch in the Executable Selection page, then click Next.<br />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    40
 
            <p><img src="../images/new_launch_config_03.png" width="671" height="433"></p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    41
 
        </li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    42
 
        <li>Set the Build (if required) before launching option in the Build Options Selection page, then click Next.<br />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    43
 
            <p><img src="../images/new_launch_config_04.png" width="671" height="433"></p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    44
 
        </li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    45
 
		<li>Verify the new launch configuration settings in the New Launch Configuration page.<br />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    46
 
        	<p><img src="../images/new_launch_config_05.png" width="671" height="433"></p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    47
 
        </li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    48
 
        <li>(Optional) Checkmark the Advanced settings option to further customize the launch configuration.</li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    49
 
        <li>Click Finish. <br />
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    50
 
            <p>Carbide launches the emulator,  transfers the HelloWorld executable to it, then launches the program (see below). You can then use the soft-keys to choose actions from the <strong>Options</strong> soft-menu. Click the <strong>Exit</strong> soft-key to close the emulator and return to Carbide.c++.</p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    51
 
            <p align="left"><img src="../images/new_launch_config_08.png" alt="Emulator" width="235" height="450"></p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    52
 
        </li>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    53
 
    </ol>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    54
 
    <p>With a launch configuration in place, its now possible to edit, build, and run a project in the emulator. However, since none of us can write perfect code the first time the use of a debugger is essential for further development of our project.</p>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    55
 
</div>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    56
 
<h4><strong>NEXT STEP</strong> &gt; <a href="new_proj_from_template_04.htm">Controlling and debugging</a> the running program using  the Carbide debugger</h4>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    57
 
<h4>Other references</h4>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    58
 
<ul>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    59
1617
94b6d1326534 revised dll example with new images, TOC, and welcome page
fturovic <frank.turovich@nokia.com>
parents: 1610
diff changeset 
    60
 
    <li><a href="new_proj_from_template_00.htm">Creating and Debugging New Projects Tutorial</a><a href="./"></a><a href="./"></a></li>
1610
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    61
 
</ul>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    62
 
<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>
5e244b89116e revised Create New Project tutorial, updated images, TOC, and welcome link
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    63
 












5e244b89116e
revised Create New Project tutorial, updated images, TOC, and welcome link



fturovic <frank.turovich@nokia.com>


parents: 

diff
changeset




    64


</body>













5e244b89116e
revised Create New Project tutorial, updated images, TOC, and welcome link



fturovic <frank.turovich@nokia.com>


parents: 

diff
changeset




    65


</html>














FCL/sftools/dev/ide/carbidecpp