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/launch/wiz_new_launch_config.htm
author fturovic <frank.turovich@nokia.com>
Fri, 06 Aug 2010 14:28:38 -0500
changeset 1791 727385d8e2b3
parent 1754 a1e1c11d5a44
child 1933 a77f12f0a631
permissions -rw-r--r--
added new customize carbide section and some relinking done for deleted duplicate page
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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>
400
9b005a8e6778 removed duplicate pages, unused images, and fixed links to same
fturovic <frank.turovich@nokia.com>
parents: 345
diff changeset 
    13
 
<p>The <b>New Launch Configuration Wizard</b> launches when no launch configuration exists for 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 Application TRK requires different information than  one targeted for System TRK. </p>
264
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    14
 
<table width="700"  border="0" cellpadding="2" cellspacing="0">
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    15
 
  <tr>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    16
 
    <th width="41%" scope="col">Launch Configuration</th>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    17
 
    <th width="59%" scope="col">Wizard Pages</th>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    18
 
  </tr>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    19
 
  <tr>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    20
 
    <td><b>Common pages</b></td>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    21
 
    <td><ul>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    22
 
      <li><a href="#CATEGORY">Category Type</a></li>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    23
 
      <li><a href="#LAUNCH">Launch Type</a></li>
279
9abb752d5c0a Updated New Launch Config and Launch Config Main pages
fturovic <frank.turovich@nokia.com>
parents: 264
diff changeset 
    24
 
      <li><a href="#BLD_OPT">Build Option Selection</a></li>
264
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    25
 
      <li><a href="#EXE_SEL">Executable Selection</a></li>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    26
 
      <li><a href="#FINISH">New Launch Configuration</a></li>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    27
 
    </ul>      </td>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    28
 
  </tr>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    29
 
  <tr>
345
9d9aecf552ee [bug 9352] added emulation item, removed outdated paragraph, and converted auto to automatic
fturovic <frank.turovich@nokia.com>
parents: 279
diff changeset 
    30
 
    <td><b>Emulation</b></td>
9d9aecf552ee [bug 9352] added emulation item, removed outdated paragraph, and converted auto to automatic
fturovic <frank.turovich@nokia.com>
parents: 279
diff changeset 
    31
 
    <td><ul>
9d9aecf552ee [bug 9352] added emulation item, removed outdated paragraph, and converted auto to automatic
fturovic <frank.turovich@nokia.com>
parents: 279
diff changeset 
    32
 
      <li><a href="#EXE_SEL">Executable Selection</a></li>
9d9aecf552ee [bug 9352] added emulation item, removed outdated paragraph, and converted auto to automatic
fturovic <frank.turovich@nokia.com>
parents: 279
diff changeset 
    33
 
      <li><a href="#BLD_OPT">Build Option Selection</a></li>
9d9aecf552ee [bug 9352] added emulation item, removed outdated paragraph, and converted auto to automatic
fturovic <frank.turovich@nokia.com>
parents: 279
diff changeset 
    34
 
      <li><a href="#FINISH">New Launch Configuration</a></li>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 819
diff changeset 
    35
 
      </ul>    </td>
345
9d9aecf552ee [bug 9352] added emulation item, removed outdated paragraph, and converted auto to automatic
fturovic <frank.turovich@nokia.com>
parents: 279
diff changeset 
    36
 
  </tr>
9d9aecf552ee [bug 9352] added emulation item, removed outdated paragraph, and converted auto to automatic
fturovic <frank.turovich@nokia.com>
parents: 279
diff changeset 
    37
 
  <tr>
264
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    38
 
    <td><b>Application TRK and System TRK</b></td>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    39
 
    <td><ul>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    40
 
      <li><a href="#TRK_CONN">TRK Connection Settings</a></li>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    41
 
      <li><a href="#TRK_SIS">TRK SIS Selection</a> (<i>Application TRK only</i>) </li>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    42
 
    </ul>    </td>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    43
 
  </tr>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    44
 
  <tr>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    45
 
    <td><b>Attach to Process</b></td>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    46
 
    <td><ul>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    47
 
      <li><a href="#TRK_CONN">TRK Connection Settings</a></li>
345
9d9aecf552ee [bug 9352] added emulation item, removed outdated paragraph, and converted auto to automatic
fturovic <frank.turovich@nokia.com>
parents: 279
diff changeset 
    48
 
      </ul>    </td>
264
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    49
 
  </tr>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    50
 
</table>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    51
 
<p>To access the <b>New Launch Configurtion Wizard</b> click the <b>Debug</b> icon (<img src="../../images/icons/btn_debug.png" width="17" height="16" align="absmiddle">). If no launch configuration exists for the  build target the wizard is launched. If a launch configuration already exists, then that launch configuration is launched and not the wizard.</p>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    52
 
<p align="center"><img src="../../images/icons/menu_build_target.png" width="270" height="120"></p>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    53
 
<p class="figure">Figure 1 - Build Target selection list </p>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    54
 
<h3><a name="CATEGORY" id="LAUNCH2"></a>Category Types</h3>
279
9abb752d5c0a Updated New Launch Config and Launch Config Main pages
fturovic <frank.turovich@nokia.com>
parents: 264
diff changeset 
    55
 
<p>Use the<b> Category Types</b> page to select the the  launch category.  The choices include Phone, Board, and possibly others. The choice made here filters the <b>Launch Types</b> page to  only show valid launch configurations. Once a category is selected, click <b>Next</b>. </p>
264
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    56
 
<p align="center"><img src="images/wiz_launch_config_categories.png" width="438" height="533"></p>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    57
 
<p class="figure">Figure 2 - Category Types page </p>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    58
 
<h3><a name="LAUNCH" id="LAUNCH"></a>Launch Types</h3>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    59
 
<p>Use the<b> Launch Types</b> page to select the type of launch configuration for the build target. This page does not appear when using an Emulator target. Available types are listed from the most frequently chosen (Application TRK) to the least likely type (Attach to Process). Select a type and click <b>Next</b>. </p>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    60
 
<p align="center"><img src="../../images/icons/wiz_launch_config_launch_types.png" width="438" height="533"></p>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    61
 
<p class="figure">Figure 3 - Launch Type page </p>
279
9abb752d5c0a Updated New Launch Config and Launch Config Main pages
fturovic <frank.turovich@nokia.com>
parents: 264
diff changeset 
    62
 
<h3><a name="BLD_OPT" id="EXE_SEL2"></a>Build Options Selection </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 
    63
 
<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>
279
9abb752d5c0a Updated New Launch Config and Launch Config Main pages
fturovic <frank.turovich@nokia.com>
parents: 264
diff changeset 
    64
 
<p align="center"><img src="images/wiz_launch_config_build_options.png" width="484" height="533"></p>
9abb752d5c0a Updated New Launch Config and Launch Config Main pages
fturovic <frank.turovich@nokia.com>
parents: 264
diff changeset 
    65
 
<p class="figure">Figure 4 - Build Options Selection page </p>
264
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    66
 
<h3><a name="EXE_SEL" id="EXE_SEL"></a>Executable Selection </h3>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    67
 
<p>Use the <b>Application Selection </b> page to choose a binary created by the project to launch and debug and verify its location. If only a single binary is available the <b>Process to launch</b> option is disabled. </p>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    68
 
<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>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    69
 
<p>Use the <b>Specify device path of remote process to launch</b> option to specify alternate paths for launching the executable from RAM (c:\sys\bin\), ROM (z:\sys\bin\) or  memory cards (e:\sys\bin\) . </p>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    70
 
<p>Select the Executable to launch, verify it is the correct binary, then click <b>Next</b>. </p>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    71
 
<p align="center"><img src="../../images/icons/wiz_launch_config_app_selection.png" width="438" height="533"> </p>
279
9abb752d5c0a Updated New Launch Config and Launch Config Main pages
fturovic <frank.turovich@nokia.com>
parents: 264
diff changeset 
    72
 
<p class="figure">Figure 5 - 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 
    73
 
<h3><a name="TRK_CONN" id="TRK_CONN"></a>TRK Connection Settings </h3>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    74
 
<p>Use the <b>TRK Connection Settings</b> page to specify the connection used to communicate with the target device. If the device is already connected, the drop down list will include both the COM port and the name of the device using that port. Use the <a href="../../reference/trk/wnd_on_device_setup.htm">On-Device Conection</a> dialog to verify and update all Carbide software services on the device. Choose the serial port used to communicate with the target device and click <b>Next</b>. </p>
279
9abb752d5c0a Updated New Launch Config and Launch Config Main pages
fturovic <frank.turovich@nokia.com>
parents: 264
diff changeset 
    75
 
<p align="center"><img src="../../images/icons/wiz_launch_config_trk_conn.png" width="487" height="533"> </p>
9abb752d5c0a Updated New Launch Config and Launch Config Main pages
fturovic <frank.turovich@nokia.com>
parents: 264
diff changeset 
    76
 
<p class="figure">Figure 6 - TRK Connection Settings  page </p>
264
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    77
 
<p>&nbsp;</p>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    78
 
<h3><a name="TRK_SIS" id="TRK_SIS"></a>TRK SIS Selection</h3>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    79
 
<p>Use the <b>TRK SIS Selection</b> page to select the SIS file to install on the target device. Click the <b>Modify SIS builder settings for build configuration</b> link to open the <a href="../../reference/build_properties/pane_build_config_sis.htm">SIS Builder</a> properties pane to add, edit, or review  the SIS files to build. Once the correct SIS File to Install is selected, click <b>Next</b>. </p>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    80
 
<p align="center"><img src="../../images/icons/wiz_launch_config_trk_sis.png" width="463" height="533"></p>
279
9abb752d5c0a Updated New Launch Config and Launch Config Main pages
fturovic <frank.turovich@nokia.com>
parents: 264
diff changeset 
    81
 
<p class="figure">Figure 7 - TRK SIS Selection page </p>
264
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    82
 
<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 
    83
 
<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 
    84
 
<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>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    85
 
<p align="center"><img src="../../images/icons/wiz_launch_config_finish.png" width="438" height="533"></p>
279
9abb752d5c0a Updated New Launch Config and Launch Config Main pages
fturovic <frank.turovich@nokia.com>
parents: 264
diff changeset 
    86
 
<p class="figure">Figure 8 - New Launch Configuration page </p>
264
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    87
 
<h5>Other references</h5>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    88
 
<ul>
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    89
 
  <li><a href="../../projects/launch/launch_configs_overview.htm">Launch Configuration</a>  </li>
1207
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 819
diff changeset 
    90
 
  <li><a href="launch_emulator.htm">Symbian OS Emulator Launch</a></li>
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 819
diff changeset 
    91
 
  <li><a href="launch_phone.htm">Symbian OS Phone Launch</a></li>
e265bbe56eb0 merge 2.6 changes to 3.0 docs
fturovic <frank.turovich@nokia.com>
parents: 819
diff changeset 
    92
 
  <li><a href="launch_board.htm">Symbian OS Reference Board Launch</a></li>
264
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    93
 
</ul>
819
8121a281245c BUG 10603 - removed sophia text references from 3.0
fturovic <frank.turovich@nokia.com>
parents: 400
diff changeset 
    94
 
<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>
264
c8bd296c5b92 moved and updated page with category wizard page
fturovic <frank.turovich@nokia.com>
parents:
diff changeset 
    95
 












c8bd296c5b92
moved and updated page with category wizard page



fturovic <frank.turovich@nokia.com>


parents: 

diff
changeset




    96


</body>













c8bd296c5b92
moved and updated page with category wizard page



fturovic <frank.turovich@nokia.com>


parents: 

diff
changeset




    97


</html>














FCL/sftools/dev/ide/carbidecpp