core/com.nokia.carbide.cpp.doc.user/html/concepts/build_configurations.htm
author fturovic <frank.turovich@nokia.com>
Wed, 06 Oct 2010 10:31:32 -0500
changeset 2131 ff0156b93599
parent 1933 a77f12f0a631
permissions -rw-r--r--
moved inf, mmp, remote conn, and views to project folder
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1448
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     2
<html>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     3
<head>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     6
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     7
<title>Active Build Configuration</title>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     8
<link rel="StyleSheet" href="../../book.css" type="text/css"/>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
     9
</head>
1791
727385d8e2b3 added new customize carbide section and some relinking done for deleted duplicate page
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    10
<body >
1448
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    11
<h2>Active  Build Configuration</h2>
1658
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1515
diff changeset
    12
<p>Use the <b>Active  Configuration</b> option in the <a href="../reference/build_properties/prop_carb_build_config.htm">Carbide Build Configurations</a> panel to specify the build target. Since a project can contain one or more build targets, the active  configuration defines  which build configuration to use when the project is run or debugged. A launch configuration consists of the following:</p>
1448
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    13
<ul>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    14
  <li>a project</li>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    15
  <li>a <a href="../projects/launch/launch_configs_overview.htm">build  configuration</a> -  a project level configuration that includes an  SDK and any related files required to compile and build the project </li>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    16
</ul>
2131
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents: 1933
diff changeset
    17
<p>Build configurations are defined when the project is created. A project can have any number of build configurations and more  can be <a href="../tasks/projects/prj_new_build_config.htm">added</a> as necessary. Each build configuration can have its own combination of tool settings to precisely control how it is defined and built. Build configurations are maintained in the project Properties window in the Carbide Build Configurations panel. To open the panel, select a project in the <a href="../projects/views/view_proj_explorer.htm">Project Explorer</a> or <a href="../projects/views/view_sym_proj_nav.htm">Symbian Project Navigator</a> view and select <b>Project &gt; Properties</b> or right-click and select Properties.</p>
1515
494fafafc064 removed dependency tracking page sbsv1-only
fturovic <frank.turovich@nokia.com>
parents: 1448
diff changeset
    18
<p align="center"><img src="images/build_configs.png" width="801" height="350"></p>
1933
a77f12f0a631 BUG 10651 - added debugging dll with any process info, revised launch config pages and others
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    19
<p>You can select a build configuration in the <b>Active Configuration</b> group or use the <b>Project &gt; Active  Configuration</b> menu option  to <a href="../tasks/projects/prj_set_build_tgt.htm">set</a> which build configuration to launch when running or debugging a program. The currently selected project can be launched by clicking the <b>Run</b> (<img src="../images/icons/btn_run.png" width="16" height="16" align="absmiddle" />) or <b>Debug</b> (<img src="../projects/images/icon_debug.png" width="17" height="16" align="absmiddle" />) control on the tool bar to launch the project with the currently active build configuration. When no project is selected the last project debugged will be launched.</p>
1448
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    20
<p>If no <a href="../projects/launch/launch_configs_overview.htm">launch configuration</a> is present in the project, one is created on initial launch. Subsequent launches of the project will use either the last launch configuration or if more than one launch configuration exists, it uses the most correct one.</p>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    21
<p class="note"><b>NOTE</b> The Carbide <b>Run</b> and <b>Debug</b> buttons are shaded in blue to indicate their behavior differs from the standard Eclipse behavior.</p>
1515
494fafafc064 removed dependency tracking page sbsv1-only
fturovic <frank.turovich@nokia.com>
parents: 1448
diff changeset
    22
<h5>Table 1 Build Configuration items </h5>
1448
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    23
<table width="100%"  border="0" cellpadding="2" cellspacing="0">
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    24
  <tr>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    25
    <th width="20%" scope="col">Item</th>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    26
    <th width="71%" scope="col">Explanation</th>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    27
  </tr>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    28
  <tr>
1515
494fafafc064 removed dependency tracking page sbsv1-only
fturovic <frank.turovich@nokia.com>
parents: 1448
diff changeset
    29
    <td width="20%"><b>Configuration </b></td>
494fafafc064 removed dependency tracking page sbsv1-only
fturovic <frank.turovich@nokia.com>
parents: 1448
diff changeset
    30
    <td>The <b> Configuration</b> drop down list allows you to <a href="../tasks/projects/prj_set_build_tgt.htm">select</a> a configuration that is currently available for the selected project. The entries in the related sub-panes will change according to the selected configuration. The Configuration name consists of a target name and an SDK identifier in brackets.</td>
1448
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    31
  </tr>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    32
  <tr>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    33
    <td width="20%"><b>Manage...</b></td>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    34
    <td>Click the <b>Manage</b>... button to <a href="../tasks/projects/prj_new_build_config.htm">add</a> a new SDK/Configuration or remove an existing configuration.</td>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    35
  </tr>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    36
</table>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    37
<h5>Build Configuration Naming</h5>
1515
494fafafc064 removed dependency tracking page sbsv1-only
fturovic <frank.turovich@nokia.com>
parents: 1448
diff changeset
    38
<p>When the Carbide.c++ IDE creates an build  configuration it uses a standard naming convention to make it easy to identify. For example, <span class="code">HelloCarbide (armv5_udeb) Emulator Debug</span> is a typical configuration name.  The default name follows the form of:</p>
1448
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    39
<ul>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    40
  <li><span class="code">&lt;Phone|Emulator&gt; </span>The build target (Emulator, Phone, etc.)</li>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    41
  <li><span class="code">&lt;Debug|Release&gt; </span>Debug (final file contains debug symbols) or Release version</li>
1515
494fafafc064 removed dependency tracking page sbsv1-only
fturovic <frank.turovich@nokia.com>
parents: 1448
diff changeset
    42
  <li><span class="code">&lt;platform_build&gt; </span>Platform on which you are building (<span class="code">winscw_urel</span>, <span class="code">armv5_udeb</span>)</li>
494fafafc064 removed dependency tracking page sbsv1-only
fturovic <frank.turovich@nokia.com>
parents: 1448
diff changeset
    43
  <li><span class="code">&lt;sdk ID from devices.xml&gt; </span>The SDK and version used by the build configurations (Symbian3, etc.)</li>
1448
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    44
</ul>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    45
<p>You can use the  <a href="../reference/wnd_debug_configuration.htm">Debug</a> window to edit the default build configuration names.</p>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    46
<h5>Other references </h5>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    47
<ul>
1658
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1515
diff changeset
    48
  <li><a href="../reference/build_properties/prop_carb_build_config.htm">Build Configurations</a> </li>
1448
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    49
  <li><a href="../tasks/projects/prj_set_build_tgt.htm">Setting an Active Configuration</a></li>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    50
  <li><a href="../tasks/projects/prj_debug_config.htm">Creating Launch Configurations</a> </li>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    51
  <li><a href="../tasks/projects/prj_new_build_config.htm">Adding/Removing Build Configurations</a></li>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    52
</ul>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    53
<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>
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    54
e1fbef8f8f8c added Install Extension view page and related images and links
fturovic <frank.turovich@nokia.com>
parents: 1207
diff changeset
    55
</body>
0
fb279309251b DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff changeset
    56
</html>