mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-07-29 20:05:35 +02:00
30a3b9c06f
All .htm files have changed for Copyright notice change. New search docs (including indexer), new screen caps.
123 lines
No EOL
5.8 KiB
HTML
123 lines
No EOL
5.8 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//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>Building C/C++ projects</title>
|
|
<link rel="stylesheet" type="text/css" href="../help.css">
|
|
</head>
|
|
<body>
|
|
<h1>Building C/C++ projects</h1>
|
|
|
|
<p>The CDT relies on an external make utility, such as GNU make, to build a project.
|
|
The CDT can generate makefiles automatically when you create a Managed Make C project or a Managed Make C++ project.
|
|
You have the option of creating a Standard Make C project or a Standard Make C++ project and providing the makefile yourself.</p>
|
|
<h2>Required utilities</h2>
|
|
<p>You must install and configure the following utilities:
|
|
<ul>
|
|
<li>Build (e.g. make).</li>
|
|
<li>Compile (e.g. gcc).</li>
|
|
<li>Debug (e.g. gdb).</li>
|
|
</ul>
|
|
<b>Note: </b> while make, gcc and gdb are the examples used in the documentation, virtually any similar set of tools or utilities could be used.</p>
|
|
|
|
<p><b>Tip: </b>Cygwin contains these utilities (make, gcc and gdb) for a Windows environment, while running the cygwin installation ensure <tt>gcc</tt> and <tt>make</tt> are selected, they are not installed by default.
|
|
For more information, see <a href="http://www.cygwin.com">http://www.cygwin.com</a>. Red Hat users, all you need to build your project is included in the Red Hat Linux installation.
|
|
For other operating systems please refer to your installation documentation.</p>
|
|
</p>
|
|
|
|
<h2>Build terminology</h2>
|
|
|
|
<p>The CDT uses a number of terms to describe the scope of the build. </p>
|
|
|
|
<h3>Build Project</h3>
|
|
|
|
<p>This is an incremental build (make all, assuming all is defined in your makefile). Only the components affected by modified files in that particular project are built.</p>
|
|
|
|
<h3>Rebuild Project</h3>
|
|
|
|
<p>Builds every file in the project whether or not a file has been modified since the last build. A rebuild is a clean followed by a build.</p>
|
|
|
|
<p>For more information on builds, see:</p>
|
|
<ul>
|
|
<li><b>Workbench User Guide > Concepts > Workbench > Builds</b></li>
|
|
<li><b>Workbench User Guide > Tasks > Building resources</b></li>
|
|
</ul>
|
|
|
|
<p>Build-related information is displayed as follows:</p>
|
|
|
|
<ul>
|
|
<li>The Console view displays the output of the build tools.</li>
|
|
<li>The Tasks view displays a list of compiler errors and warnings related to your projects.</li>
|
|
<li>Makefile targets are displayed in the Make Targets view.</li>
|
|
</ul>
|
|
|
|
<p>For more information about the Tasks view, see <b>Workbench User Guide > Reference > User interface information > Views and editors > Tasks view</b>.</p>
|
|
|
|
<h2>Getting a makefile</h2>
|
|
|
|
<p>You can either create a C/C++ project for which you supply the <b>makefile</b> or create a C/C++ project for which the CDT generates makefiles automatically.</p>
|
|
|
|
<p>To create a new project, from the menu bar choose <b>File > New > Project</b>. In the dialog that appears:</p>
|
|
|
|
<ul>
|
|
<li>To create a project for which you supply the <b>makefile</b>, select either <b>Standard Make C project</b> or <b>Standard Make C++ project</b>. </li>
|
|
<li>To create a project for which the CDT supplies a basic <b>makefile</b>, select either <b>Managed Make C project</b> or <b>Managed Make C++ project</b>. </li>
|
|
</ul>
|
|
|
|
<h2>Setting build preferences</h2>
|
|
|
|
<p>You can set build preferences in Eclipse:</p>
|
|
|
|
<dl>
|
|
<dt>Build order</dt>
|
|
<dd>If certain projects must be built before others, you can set the <i>build order</i>.
|
|
If your project refers to another project, the CDT must build the other project first.
|
|
To set the build order, from the menu bar select <b>Window > Preferences > Build Order</b>.
|
|
<p>When you set the build order, the CDT does not rebuild projects that depend on a project;
|
|
you must rebuild all projects to ensure all changes are propagated.</p></dd>
|
|
<dt>Automatic save</dt>
|
|
<dd>You can set the CDT to perform an <i>automatic save</i> of all modified resources when you perform a manual build;
|
|
from the menu bar, select <b>Windows > Preferences > Workbench</b>.By default, this feature is enabled.</dd>
|
|
</dl>
|
|
|
|
<h2>Controlling the building of your project</h2>
|
|
|
|
<p>The C/C++ compiler that a project uses is controlled by the project's <b>Properties</b> setting.
|
|
To view a project's properties, right-click on the project and select <b>Properties</b>.
|
|
In the dialog that appears, the <b>C/C++ Standard Make Project</b> page enables you to control a variety of settings, including:</p>
|
|
<dl>
|
|
<dt>Build Setting</dt>
|
|
<dd>Controls whether the compiler will <b>Stop On Error</b>or <b>Keep Going On Error</b>.
|
|
Choosing <b>Keep Going On Error</b> will force the compiler to attempt to build all referenced projects even if the current project has errors.</dd>
|
|
<dt>Build Command</dt>
|
|
<dd>Controls which make is used.</dd>
|
|
<dt>Workbench Build Behavior</dt>
|
|
<dd>Controls which makefile target will be built depending on the scope of the build.</dd>
|
|
</dl>
|
|
|
|
<h2>Viewing build information</h2>
|
|
|
|
<p>Build-related information is displayed as follows: </p>
|
|
<ul>
|
|
<li>The <b>Console</b> view displays the output of the make utility.</li>
|
|
<li>The <b>Tasks</b> view displays a list of compiler errors and warnings related to your projects. </li>
|
|
<li>Build actions display in the <b>Make Targets</b> view.</li>
|
|
</ul>
|
|
|
|
<p><img border="0" src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21">
|
|
<br>
|
|
<a href="cdt_c_projects.htm">CDT Projects</a><br>
|
|
<a href="cdt_c_proj_file_views.htm">Project file views</a></p>
|
|
<p><img border="0" src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21">
|
|
<br>
|
|
<a href="../tasks/cdt_o_proj_prop.htm">Defining project properties</a><br>
|
|
<a href="../tasks/cdt_o_build_task.htm">Building</a></p>
|
|
<p>
|
|
<img src="../images/rh03_04.gif" ALT="Red Hat Copyright Statement"><br>
|
|
<img src="../images/ng00_04a.gif" ALT="IBM Copyright Statement">
|
|
</p>
|
|
</body>
|
|
|
|
</html> |