core/com.nokia.carbide.cpp.doc.user/html/concepts/build_configurations.htm
author fturovic <frank.turovich@nokia.com>
Fri, 16 Apr 2010 09:51:37 -0500
branchRCL_2_4
changeset 1225 a546534a48de
parent 939 47d3ca29d054
permissions -rw-r--r--
minor edits to remote conn pages, updated copyrights, fixed some broken links
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
939
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     2
<html>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     3
<head>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     6
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     7
<title>Active Build Configuration</title>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     8
<link rel="StyleSheet" href="../../book.css" type="text/css"/>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     9
</head>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    10
<body bgcolor="#FFFFFF">
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    11
<h2>Active  Build Configuration</h2>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    12
<p>Use the <b>Active  Configuration</b> option in the <a href="../reference/build_properties/pane_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>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    13
<ul>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    14
  <li>a project</li>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
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>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    16
</ul>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
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="../reference/view_sym_proj_nav.htm">Symbian Project Navigator</a> or <a href="../reference/view_cpp_projects.htm">Project Explorer</a> view and select <b>Project &gt; Properties</b> or right-click and select Properties.</p>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    18
<p align="center"><img src="images/build_configs.png" width="795" height="679"></p>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    19
<p>You can select a build configuration in the <b>Active Configuration</b> dropdown list 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="../images/icons/btn_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>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
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>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
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>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    22
<h5>Table 1 Carbide Build Configuration items </h5>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    23
<table width="100%"  border="0" cellpadding="2" cellspacing="0">
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    24
  <tr>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    25
    <th width="20%" scope="col">Item</th>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    26
    <th width="71%" scope="col">Explanation</th>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    27
  </tr>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    28
  <tr>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    29
    <td width="20%"><b>Active Configuration </b></td>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    30
    <td>The <b>Active 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>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    31
  </tr>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    32
  <tr>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    33
    <td width="20%"><b>Manage...</b></td>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
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>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    35
  </tr>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    36
</table>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    37
<h5>Build Configuration Naming</h5>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
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 S60 5.0 Emulator Debug</span> is a typical configuration name.  The default name follows the form of:</p>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    39
<ul>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    40
  <li><span class="code">&lt;Phone|Emulator&gt; </span>The build target (Emulator, Phone, etc.)</li>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    41
  <li><span class="code">&lt;Debug|Release&gt; </span>Debug (final file contains debug symbols) or Release version</li>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    42
  <li><span class="code">&lt;platform&gt; </span>Platform on which you are building</li>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    43
  <li><span class="code">&lt;sdk ID from devices.xml&gt; </span>The SDK and version used by the build configurations (S60, etc.)</li>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    44
</ul>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
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>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    46
<h5>Other references </h5>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    47
<ul>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    48
  <li><a href="../reference/build_properties/pane_build_config.htm">Carbide Build Configurations</a> </li>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    49
  <li><a href="../tasks/projects/prj_set_build_tgt.htm">Setting an Active Configuration</a></li>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    50
  <li><a href="../tasks/projects/prj_debug_config.htm">Creating Launch Configurations</a> </li>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    51
  <li><a href="../tasks/projects/prj_new_build_config.htm">Adding/Removing Build Configurations</a></li>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    52
</ul>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
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>
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    54
47d3ca29d054 revision of concept section of manual pages and images
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    55
</body>
0
fb279309251b DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff changeset
    56
</html>