mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-04-29 19:45:01 +02:00
259 lines
14 KiB
HTML
259 lines
14 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
|
|
<html lang="en">
|
|
<head>
|
|
<meta http-equiv="Content-Language" content="en-us">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<title>C/C++ Project Properties, Managed, Build</title>
|
|
<link rel="stylesheet" type="text/css" href="../help.css">
|
|
<style>
|
|
<!--
|
|
li.MsoNormal
|
|
{mso-style-parent:"";
|
|
margin-bottom:.0001pt;
|
|
font-size:12.0pt;
|
|
font-family:"Times New Roman";
|
|
margin-left:0in; margin-right:0in; margin-top:0in}
|
|
-->
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<h1>C/C++ Project Properties, Managed, C/C++ Build, Environment</h1>
|
|
Customizes the environment variables to be used in building your build
|
|
configuration.
|
|
<p><img img="" src="../images/mprop_env.png"
|
|
alt="C/C++ Project Properties, Managed, C/C++ Build, Environment"></p>
|
|
<p></p>
|
|
<dl>
|
|
<dt>Project Type:</dt>
|
|
<dd>Displays the type of project that is built by the selected build
|
|
configuration.</dd>
|
|
<dt>Configuration:</dt>
|
|
<dd>Specifies the selected build configuration from the list provided.</dd>
|
|
<dt>Manage...</dt>
|
|
<dd>Adds, removes, renames and converts configurations.</dd>
|
|
<dt>Configuration Settings</dt>
|
|
<dd>Adds, removes and edits environment variables for a project or
|
|
configuration. Each tab contains two tables - one for
|
|
user-defined environment variables and one for non user-defined
|
|
environment variables. Each table contains two columns<b>:</b>
|
|
<p><b>Name</b> of the environment variable</p>
|
|
<p><b>Value </b>of the environment variable. </p>
|
|
<p>You can view all environment variables that are not user-defined
|
|
in the <b>System Variables</b> table.<span
|
|
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;"> </span><span
|
|
style="font-style: normal; font-variant: normal; font-weight: normal;">You</span>
|
|
can choose to also display all variables defined for lower-precedence
|
|
contexts in the <b>System Variables</b> table by checking the <b>Show
|
|
parent level variables</b> checkbox. System variables are read-only.</p>
|
|
<p class="MsoNormal">You can view all user-defined variables in the
|
|
<b>User Variables</b> table.<span
|
|
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;">
|
|
</span>A user-defined variable overrides a non user-defined
|
|
variable of the same name for the given level. Overridden
|
|
variables are displayed in bold in the <b>System Variables</b> table. </p>
|
|
</dd>
|
|
<dt>Restore Defaults</dt>
|
|
<dd>Returns any changes back to their default setting.</dd>
|
|
<dt>Apply</dt>
|
|
<dd>Applies any changes.</dd>
|
|
</dl>
|
|
<h2>Detailed Specification</h2>
|
|
<p style="margin-top: 15px; margin-bottom: 0pt;">Users and tool-chain
|
|
integrators can define the set of environment variables to be used
|
|
while the build process is executing. </p>
|
|
<p class="MsoNormal" style="margin-top: 0pt; margin-bottom: 0pt;">Since
|
|
the environment variable names are case sensitive on Unix-like systems
|
|
and case insensitive on Windows systems, the Managed Build System (MBS)
|
|
will treat the variable names in the same manner as the host system.</p>
|
|
<ul>
|
|
<li>
|
|
<p class="MsoNormal" style="margin-top: 10px; margin-bottom: 0pt;">MBS
|
|
will allow tool-integrators and users to specify multiple variables
|
|
whose names differ only in case on systems that support case sensitive
|
|
variable names and will not allow them to do that on Windows systems. </p>
|
|
</li>
|
|
<li>
|
|
<p class="MsoNormal" style="margin-top: 10px; margin-bottom: 0pt;">MBS
|
|
will also treat variable names as case sensitive (on Unix-like systems)
|
|
or case insensitive (on Windows systems) in its own operations
|
|
(overriding a lower-level variable, etc.) </p>
|
|
</li>
|
|
</ul>
|
|
<p class="MsoNormal"><span lang="EN-US">Build Environment variables can
|
|
be specified at several levels:</span></p>
|
|
<blockquote>
|
|
<p class="MsoNormal" style="margin-top: 0pt; margin-bottom: 0pt;"> <span
|
|
lang="EN-US">1.<span
|
|
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;">
|
|
</span>Configuration level – variables specific to the selected
|
|
configuration</span></p>
|
|
<p class="MsoNormal"
|
|
style="text-indent: -0.25in; margin-left: 0.25in; margin-top: 0pt; margin-bottom: 0pt;">
|
|
<span lang="EN-US">2.<span
|
|
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;">
|
|
</span>Project level – variables specific to the selected project and
|
|
common for all project configurations</span></p>
|
|
<p class="MsoNormal"
|
|
style="text-indent: -0.25in; margin-left: 0.25in; margin-top: 0pt; margin-bottom: 0pt;">
|
|
<span lang="EN-US">3.<span
|
|
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;">
|
|
</span>Workspace level – variables specific to the current workspace</span></p>
|
|
<p class="MsoNormal"
|
|
style="text-indent: -0.25in; margin-left: 0.25in; margin-top: 0pt; margin-bottom: 0pt;">
|
|
<span lang="EN-US">4.<span
|
|
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;">
|
|
</span>System environment passed to eclipse</span></p>
|
|
</blockquote>
|
|
<p class="MsoNormal"><span lang="EN-US">When running the build utility
|
|
for the selected configuration, the process' total environment
|
|
variables set will be generated, including variables from all specified
|
|
levels. Levels have precedence over each other as specified in the
|
|
above list. So, for example, if configuration level and workspace level
|
|
have a variable of the same name, the configuration variable will take
|
|
precedence, etc.</span></p>
|
|
<p style="margin-bottom: 0pt;">Users can create and delete environment
|
|
variables for any given project configuration, for the entire project
|
|
or for the entire workspace.</p>
|
|
<p style="margin-bottom: 0pt;">To create a new variable the "New"
|
|
button should be pressed. A dialog box representing the variable
|
|
definition will appear.<br>
|
|
</p>
|
|
<p style="margin-bottom: 0pt;">
|
|
<img border="0" src="../images/mprop_env_new_repl.PNG" width="433"
|
|
height="223"></p>
|
|
<p style="margin-bottom: 0pt;"> </p>
|
|
<p style="margin-top: 0pt;">A variable definition contains the name,
|
|
the value, the delimiter and the "operation" <span lang="EN-US">to
|
|
perform on the variable of the same name defined at the
|
|
lower-precedence level. The following "operations" are defined: </span></p>
|
|
<p class="MsoNormal"
|
|
style="text-indent: -0.25in; margin-left: 53.25pt; margin-top: 0pt;">
|
|
<span lang="EN-US" style="font-family: Symbol;">·<span
|
|
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;">
|
|
"</span></span><span lang="EN-US">append": If the variable
|
|
already exists, add the user-specified value to the end of any existing
|
|
value that the environment variable has. If the variable does not
|
|
yet exist, create the variable and set it to the user-specified value.</span></p>
|
|
<p class="MsoNormal"
|
|
style="text-indent: -0.25in; margin-left: 53.25pt; margin-top: 0pt;">
|
|
<span lang="EN-US" style="font-family: Symbol;">·<span
|
|
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;">
|
|
</span></span><span lang="EN-US">"prepend": If the variable
|
|
already exists, add the user-specified value to the beginning of any
|
|
existing value that the environment variable has. If the variable
|
|
does not yet exist, create the variable and set it to the
|
|
user-specified value.</span></p>
|
|
<p class="MsoNormal"
|
|
style="text-indent: -0.25in; margin-left: 53.25pt; margin-top: 0pt;">
|
|
<span lang="EN-US" style="font-family: Symbol;">·<span
|
|
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;">
|
|
"</span></span><span lang="EN-US">replace": If the variable
|
|
already exists, set the value to the user-specified value. If the
|
|
variable does not yet exist, create the variable and set it to the
|
|
user-specified value.</span></p>
|
|
<p class="MsoNormal"
|
|
style="text-indent: -0.25in; margin-left: 53.25pt; margin-top: 0pt;">
|
|
<span lang="EN-US" style="font-family: Symbol;">·<span
|
|
style="font-family: "Times New Roman"; font-style: normal; font-variant: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-stretch: normal; font-size-adjust: none;">
|
|
</span></span><span lang="EN-US">"delete": If the variable
|
|
already exists, remove the variable.</span></p>
|
|
<p>The resulting value of the variable used for the build process will
|
|
be calculated by querying all levels from bottom to top and performing
|
|
the operations for the variables defined at those levels.</p>
|
|
<p>The "Name" field contains the list of variables that are already
|
|
defined. A user can choose any variable from the list or enter a new
|
|
variable name. When the variable from the list is chosen or the name
|
|
typed by the user matches already defined variable name, the other
|
|
fields of the dialog get filled in with the current value, delimiter
|
|
and operation of that variable.</p>
|
|
<p>When the "replace" operation is selected, the "Value" field is used
|
|
to specify the variable value.</p>
|
|
<p>When either the "prepend" or "append" operation is selected, the
|
|
"Value" field becomes grayed and the "Prepended/Appended value" field
|
|
becomes visible that allows user to specify the value to be
|
|
prepended/appended. The resulting variable value will be automatically
|
|
calculated and displayed in the "Value" field. The delimiter to be used
|
|
with append/prepend operations may be specified in the "Delimiter"
|
|
field.</p>
|
|
<p>
|
|
<img border="0" src="../images/mprop_env_new_prep.png" width="433"
|
|
height="223"></p>
|
|
<p>When the "delete" operation is selected, the "Value", "Delimiter"
|
|
and "Prepended/Appended value" field becomes inaccessible.</p>
|
|
<p>When performing the variable value calculation the variable name
|
|
case sensitivity will be taken in account. That is, on Windows systems,
|
|
the variables of the different levels or provided by different
|
|
suppliers with names that differ only in case will be treated as the
|
|
same variable. Conversely, on Unix-like systems, where case sensitive
|
|
variable names are supported, variables with names that differ only in
|
|
case will be treated as different variables. </p>
|
|
<p style="margin-top: 0pt; margin-bottom: 0pt;"><img border="0"
|
|
src="../images/ngref.gif" alt="Related reference" width="143"
|
|
height="21"><br>
|
|
<a href="cdt_u_sprop_info.htm">C++ Project Properties, Standard, Info</a><br>
|
|
<a href="cdt_u_sprop_builders.htm">C++ Project Properties, Standard,
|
|
Builders</a><br>
|
|
<a href="cdt_u_sprop_file_types.htm">C++ Project Properties, Standard,
|
|
File Types</a><br>
|
|
<a href="cdt_u_sprop_includes.htm">C++ Project Properties, Standard,
|
|
Include Paths and Symbols</a><br>
|
|
<a href="cdt_u_sprop_indexer.htm">C++ Project Properties, Standard,
|
|
Indexer</a><br>
|
|
<a href="cdt_u_sprop_mbuild.htm">C++ Project Properties, Standard, Make
|
|
Builder</a><br>
|
|
<a href="cdt_u_sprop_merror.htm">C++ Project Properties, Standard,
|
|
Error Parser</a><br>
|
|
<a href="cdt_u_sprop_mbinary.htm">C++ Project Properties, Standard,
|
|
Binary Parser</a><br>
|
|
<a href="cdt_u_sprop_mdiscovery.htm">C++ Project Properties, Standard,
|
|
Discovery Options</a><br>
|
|
<a href="cdt_u_sprop_psource.htm">C++ Project Properties, Standard,
|
|
Source</a><br>
|
|
<a href="cdt_u_sprop_poutput.htm">C++ Project Properties, Standard,
|
|
Output</a><br>
|
|
<a href="cdt_u_sprop_pproj.htm">C++ Project Properties, Standard,
|
|
Projects</a><br>
|
|
<a href="cdt_u_sprop_plib.htm">C++ Project Properties, Standard,
|
|
Libraries</a><br>
|
|
<a href="cdt_u_sprop_pcontainers.htm">C++ Project Properties, Standard,
|
|
Path Containers</a><br>
|
|
<a href="cdt_u_sprop_ref.htm">C++ Project Properties, Standard, Project
|
|
References</a><br>
|
|
<a href="cdt_u_mprop_info.htm">C++ Project Properties, Managed, Info</a><br>
|
|
<a href="cdt_u_mprop_builders.htm">C++ Project Properties, Managed,
|
|
Builders</a><br>
|
|
<a href="cdt_u_mprop_build.htm">C++ Project Properties, Managed, C/C++
|
|
Build</a><br>
|
|
<a href="cdt_u_mprop_manage.htm">C++ Project Properties, Managed, Manage Configuration Dialog</a><br>
|
|
<a href="cdt_u_mprop_tool_settings.htm">C++ Project Properties,
|
|
Managed, C/C++ Build, Tool Settings</a><br>
|
|
<a href="cdt_u_mprop_build_settings.htm">C++ Project Properties,
|
|
Managed, C/C++ Build, Build Settings</a><br>
|
|
<a href="cdt_u_mprop_dcbs.htm">C++ Project Properties, Managed, C/C++
|
|
Build, Build Steps</a><br>
|
|
<a href="cdt_u_mprop_merror.htm">C++ Project Properties, Managed, C/C++
|
|
Build, Error Parsers</a><br>
|
|
<a href="cdt_u_mprop_mbinary.htm">C++ Project Properties, Managed,
|
|
C/C++ Build, Binary Parser</a><br>
|
|
<a href="cdt_u_mprop_macros.htm">C++ Project Properties, Managed, C/C++
|
|
Build, Macros</a><br>
|
|
<a href="cdt_u_mprop_documentation.htm">C++ Project Properties,
|
|
Managed, C/C++ Documentation</a><br>
|
|
<a href="cdt_u_mprop_file_types.htm">C++ Project Properties, Managed,
|
|
C/C++ File Types</a><br>
|
|
<a href="cdt_u_mprop_indexer.htm">C++ Project Properties, Managed,
|
|
C/C++ Indexer</a><br>
|
|
<a href="cdt_u_mprop_ref.htm">C++ Project Properties, Managed, Project
|
|
References</a><br>
|
|
<a href="cdt_u_mprop_refactoring_history.htm">C++ Project Properties, Managed, Refactoring History</a></p>
|
|
<p style="margin-top: 0pt; margin-bottom: 0pt;"><a
|
|
href="cdt_o_mproj_pref.htm">Managed Build Project preferences</a></p>
|
|
<p style="margin-top: 0pt; margin-bottom: 0pt;"><a
|
|
href="cdt_o_mproj_pref_env.htm">Managed Build Project preferences,
|
|
Environment</a></p>
|
|
<p style="margin-top: 0pt; margin-bottom: 0pt;"><a
|
|
href="cdt_o_mproj_pref_macro.htm">Managed Build Project preferences,
|
|
Macros</a></p>
|
|
<p><img src="../images/intl_05.gif" ALT="Intel Copyright Statement" ></p>
|
|
</body>
|
|
</html>
|