core/com.nokia.carbide.cpp.doc.user/html/reference/build_properties/prop_carb_project_settings.htm
author fturovic <frank.turovich@nokia.com>
Wed, 21 Jul 2010 13:50:58 -0500
changeset 1658 2a5c0df13bad
child 1791 727385d8e2b3
permissions -rw-r--r--
renamed files for consistency in naming
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1658
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     2
<html>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     3
<head>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     6
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     7
<title>Project Settings</title>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     8
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
     9
<style type="text/css">
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    10
<!--
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    11
.style5 {font-family: Verdana, Ariel, Helvetica, sans-serif; font-weight: bold; }
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    12
-->
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    13
</style>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    14
</head>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    15
<body bgcolor="#FFFFFF">
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    16
<h2>Project Settings</h2>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    17
<p>  Use the <b>Project Settings </b>window to specify whether all components or selected subcomponents listed in a build information file (bld.inf) should be built for the currently selected project. You can also specify whether to perform a <span class="code">clean</span> or <span class="code">reallyclean</span> command on the project before building a project.</p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    18
<p align="center"><img src="../images/carbide_proj_settings.png" width="672" height="679" /></p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    19
<p class="figure">Figure 1 -  Project Settings</p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    20
<h5>Table 1  Project Settings items </h5>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    21
<table width="100%"  border="0" cellpadding="2" cellspacing="0">
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    22
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    23
    <th width="29%" scope="col">Item</th>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    24
    <th width="57%" scope="col">Explanation</th>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    25
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    26
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    27
    <td><b>Bld.inf file</b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    28
    <td>This is the path to the bld.inf file that lists the makefile and mmp components.</td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    29
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    30
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    31
    <td><b>Bld.inf</b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    32
    <td>Select this option to ensure all components are built for the selected project. </td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    33
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    34
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    35
    <td><b>Selected Components</b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    36
    <td><p>Select this option to  specify which components of the bld.inf file to be built, including makefiles. The equivalent call to abld is <span class="code">abld build &lt;subcomponent&gt;</span>. Use the <b>Exclude extension makefiles</b> and <b>Exclude test components</b> options to manage the items that appear in the list. </p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    37
      <p>Toggle the state of each component to set its build state to true or not. A checkmark indicates a component is built. Click on a column title to sort the items by that columns contents. </p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    38
    </td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    39
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    40
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    41
    <td><b>Exclude extension makefiles </b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    42
    <td>Toggles the presense of extension makefiles in the Selected components list. </td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    43
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    44
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    45
    <td><b>Exclude test components </b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    46
    <td>Toggles the presense of test components in the Selected components list. </td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    47
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    48
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    49
    <td><b>Enable project specific settings </b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    50
    <td>Click to set project specific build settings. By default a project in the workspace uses the global build settings unless this option is enabled. See the <a href="../pref_carb_build.htm">Build</a> preference panel for details on these options. </td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    51
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    52
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    53
    <td><b>Configure Workspace Settings... </b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    54
    <td>Opens the <a href="../pref_carb_build.htm">Build</a> preference panel. </td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    55
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    56
</table>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    57
<p>&nbsp;</p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    58
<p align="center"><img src="../images/carbide_proj_settings_sbsv1.png" alt="sbsv1 tab" width="444" height="143"></p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    59
<p align="center" class="figure">Figure 2 - SBSv1 Tab</p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    60
<h5 align="left">Table 2 Symbian Build System v1 tab </h5>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    61
<table width="100%"  border="0" cellpadding="2" cellspacing="0">
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    62
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    63
    <th width="29%" scope="col">Item</th>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    64
    <th width="57%" scope="col">Explanation</th>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    65
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    66
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    67
    <td><span class="style5">Clean level </span></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    68
    <td><p>Specifies the level of clean to perform on  project files. The levels include:</p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    69
      <ul>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    70
        <li>Level 0  (<span class="code">abld clean</span>) - removes all the intermediate files created during compilation, and all the executables and import libraries created by the linker</li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    71
        <li>Level 1  (<span class="code">abld reallyclean</span>) - performs a <span class="code">clean</span> operation, but also removes all exported files and makefiles</li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    72
        <li>Level 2  (<span class="code">abld reallyclean</span>, <span class="code">bldmake clean</span>) - performs  a <span class="code">reallyclean</span> operation and then removes all files created by bldmake</li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    73
      </ul></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    74
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    75
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    76
    <td><span class="style5">Manage dependency tracking </span></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    77
    <td>If checked, the Symbian command line build system will not generate dependencies for source and resource files. These will be managed by Carbide. This can reduce build times. </td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    78
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    79
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    80
    <td><b>Show a dialog to modify build actions when modified MMPs are detected </b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    81
    <td><p>If checked, you will be asked what action to take before a build if a MMP file has been modified. </p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    82
        <p>If not checked, the default action is taken for all modified mmp files. </p></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    83
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    84
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    85
    <td><b>Default action to take when mmp files are modified </b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    86
    <td>Select either None, Link only, or Compile and Link.</td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    87
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    88
</table>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    89
<p align="left">&nbsp;</p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    90
<p align="center"><img src="../images/carbide_proj_settings_sbsv2.png" alt="sbsv2 tab" width="423" height="176"></p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    91
<p align="center" class="figure">Figure 3 - SBSv2 Tab</p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    92
<h5 align="left">Table 3 Symbian Build System v2 tab (only visible for Projects created with SBSv2 builder) </h5>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    93
<table width="100%"  border="0" cellpadding="2" cellspacing="0">
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    94
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    95
    <th width="29%" scope="col">Item</th>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    96
    <th width="57%" scope="col">Explanation</th>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    97
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    98
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
    99
    <td><b>Clean level </b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   100
    <td>Select the level of clean when cleaning a project.
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   101
      <ul>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   102
        <li><strong>abld clean</strong> erases all files created by a corresponding abld target   command (all intermediate files created during compilation and all executables and import libraries created by the linker)</li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   103
        <li><strong>abld reallyclean</strong> does what abld clean does, and also removes files   exported by abld export and makefiles generated by abld makefile, or the abld   test equivalents</li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   104
      </ul></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   105
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   106
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   107
    <td><b>Keep going  </b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   108
    <td><p>This build option tells a particular command to   keep going even if unrelated build steps report errors or files are missing.</p>    </td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   109
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   110
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   111
    <td><b>Debug mode</b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   112
    <td><p>This option generates symbolic debug information for release or debug builds,   independent of the compiler optimization level.</p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   113
      <p>By default, the build system generates symbolic debug information only for   the debug builds. With this option, the generation of symbolic debug information   is extended to release builds to support debugging of release binaries on ARM   ABI compliant platforms.</p></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   114
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   115
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   116
      <td><strong>Additional SBSv2 arguments</strong></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   117
      <td>Enter any additional arguments to pass to <span class="code">sbs.bat</span>.</td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   118
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   119
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   120
    <td><strong>Override default make engine </strong></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   121
    <td>Check this box to enable  an edit box to specify the <strong>Make engine</strong> to use, for example, eMake  from Electric Cloud.</td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   122
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   123
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   124
      <td><strong>Make engine</strong></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   125
      <td>Enter the name of a different make engine to use when building.</td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   126
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   127
</table>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   128
<h4>Related tasks</h4>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   129
<ul><li><a href="../../tasks/projects/prj_build.htm">Building Projects</a></li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   130
</ul>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   131
<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>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   132
</body>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents:
diff changeset
   133
</html>