blob: 0ca66c82b407ed90520c3c3c61a2dba2e602c7c0 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<meta name="keywords" content="NetBeans, IDE, Oracle Solaris Studio, integrated development environment, user, documentation, open source">
<meta name="description" content="This article describes the Make Dependency Checking feature for C and C++
projects in NetBeans IDE and Oracle Solaris Studio IDE. ">
<meta name="author" content="Alexey Vladykin">
<link rel="stylesheet" type="text/css" href="../../../netbeans.css">
<title>执行依赖关系检查 - NetBeans IDE</title>
</head>
<body>
<a name="top"></a>
<h1>执行依赖关系检查</h1>
<div class="articledate" style="margin-left: 0px;font-style:italic;">
撰稿人:Alexey Vladykin<br> 2014 年 3 月 [修订版本号:V8.0-1]
</div>
<!-- maintained by susanm -->
<p>本教程将向您演示如何允许 NetBeans IDE 在构建时检查项目中的文件依赖关系。由 <tt>make</tt> 实用程序通过 <tt>Makefile</tt> 中的指令执行依赖关系检查。</p>
<p><b>目录</b></p>
<img alt="此页上的内容适用于 NetBeans IDE 7.3、7.4 和 8.0" class="stamp" src="../../../images_www/articles/73/netbeans-stamp-80-74-73.png" title="此页上的内容适用于 NetBeans IDE 7.3、7.4 和 8.0">
<ul class="toc">
<li><a href="#requirements" title="要求">要求</a></li>
<li><a href="#introduction" title="简介">简介</a></li>
<li><a href="#build" title="构建过程(make 和 makefile)">构建过程(make 和 makefile)</a></li>
<li><a href="#basics" title="依赖关系生成基础知识">依赖关系生成基础知识</a></li>
<li><a href="#implementation" title="实现">实现</a></li>
</ul>
<h2><a NAME="requirements"></a>要求</h2>
<p><b>要学习本教程,您需要具备以下软件和资源。</b> </p>
<table>
<tbody>
<tr>
<th class="tblheader" scope="col">软件</th>
<th class="tblheader" scope="col">要求的版本</th>
</tr>
<tr>
<td class="tbltd1">NetBeans IDE(支持 C/C++)</td>
<td class="tbltd1"><a href="https://netbeans.org/downloads/index.html">带有 NetBeans C/C++ 插件的版本 7.3、7.4 或 8.0</a></td>
</tr>
<tr>
<td class="tbltd1">Java 开发工具包 (JDK)</td>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">版本 7 或 8</a></td>
</tr>
</tbody>
</table>
<br>
<p>有关下载并安装所需软件的信息,请参见 <a href="../../../community/releases/80/install.html">NetBeans IDE 安装说明</a><a HREF="../../../community/releases/80/cpp-setup-instructions.html">配置 NetBeans IDE 以使用 C/C++/Fortran</a><br></p>
<h2><a name="introduction"></a>简介</h2>
<p>
大的 C/C++ 项目包含数千个文件。例如,Linux 内核大约有 20,000 个文件。如果您开发的是这样一个项目并且希望在进行小的更改(例如,一行修复)之后重新构建该项目,则可以选择以下两个选项。
<ul>
<li>
完全重新构建(“清除”和“构建”操作)。这样做比较慢,但会保证一致的构建结果。
</li>
<li>
增量重新构建(“构建”操作)。这样做比较快,但能否正确重新构建所有应重新构建的内容?
</li>
</ul>
<p>
增量重新构建的主要问题在于存在 <tt>#include</tt> 指令,这些指令将一个文件的内容包含到另一个文件。包含的文件称为“文件依赖关系”。修改包含的文件应视为修改包含该文件的所有文件。间接包含(A 包含 B,B 包含 C => A 包含 C)使问题更加复杂。
</p>
<p>
NetBeans IDE 支持自动检查文件依赖关系并尽可能使增量重新构建正常工作。如果更改包含到某些源文件的头文件,然后单击“构建”,则 IDE 将仅重新构建那些真正依赖于所更改头文件的项目部分。此功能可节省时间并保证一致的构建结果。
</p>
<h3>为项目启用依赖关系检查</h3>
<p>
可控制各个特定项目的依赖关系检查。您可能需要确保启用该功能。
</p>
<p><b>为项目启用依赖关系检查:</b></p>
<ol>
<li>右键单击 "Projects"(项目)窗口中的项目,然后选择 "Properties"(属性)。</li>
<li>
在 "Project Properties"(项目属性)对话框中,选择 "Categories"(类别)列表中的 "Build"(构建)节点。
</li>
<li>在构建属性中,选中 "Enable Make Dependency Checking"(启用 Make 依赖关系检查)对应的复选框。</li>
</ol>
<br> <img alt="项目属性中的 &amp;quot;Make Dependency Checking&amp;quot;(Make 依赖关系检查)复选框" class="margin-around" src="../../../images_www/articles/73/cnd/depchecking/project-checkbox.png"> <br>
<h3>默认情况下为新项目启用依赖关系检查</h3>
<p>可以设置依赖关系检查的默认状态,以便自动为您创建的新项目启用 Make 依赖关系检查。</p>
<p><b>为在 IDE 中创建的所有新项目启用依赖关系检查:</b></p>
<ol>
<li>在 IDE 主菜单中选择 "Tools"(工具)> "Options"(选项)。</li>
<li>
单击顶部窗格中的 "C/C++" 按钮。
</li>
<li>单击 "Project Options"(项目选项)标签。</li>
<li>选中 "Enable dependency checking in generated makefiles"(在生成的 makefile 中启用依赖关系检查)对应的复选框</li>
</ol>
<br> <img alt="NetBeans 选项中的 &amp;quot;Dependency checking&amp;quot;(依赖关系检查)复选框" class="margin-around" src="../../../images_www/articles/73/cnd/depchecking/global-checkbox.png">
<h3 class="notes"></h3>
<ul>
<li>
自动依赖关系检查适用于在 IDE 中创建的 C/C++ 项目(受管项目)。IDE 将依赖关系检查逻辑构建到生成的 <tt>Makefile</tt>。对于使用现有源创建的项目,必须依赖于现有 <tt>Makefile</tt> 中的依赖关系检查逻辑(如果有)。
</li>
<li>
依赖关系检查需要来自工具集合(<tt>make</tt> 和编译器)的支持。依赖关系检查已经过 Oracle Solaris Studio 工具集合和 GNU 工具集合(包含 Cygwin 和 MinGW)的测试。
</li>
<li>
当 Oracle Solaris Studio 编译器与 Oracle Solaris <tt>make</tt> 一起使用时以及当 GNU 编译器与 GNU <tt>gmake</tt> 一起使用时,将执行依赖关系检查。不支持混合 Oracle Solaris <tt>make</tt> 与 GNU 编译器,反之亦然。
</li>
</ul>
<p>
本文的其余内容是面向那些想要知道 IDE 背后执行的操作的高级用户。
</p>
<h2><a name="build"></a>构建过程(make 和 makefile)</h2>
<p>
<tt>Makefile</tt><tt>make</tt> 实用程序所理解的特殊格式的文件)中描述了 NetBeans 中每个 C/C++ 项目的构建过程。从 GUI 构建或清除项目时,IDE 将调用 <tt>make</tt> 以执行 Makefile。通过这种方法,您可以在 IDE 外部使用 <tt>make</tt> 轻松构建项目:只需转到您的项目目录并键入 <tt>make help</tt> 即可获得指令。
</p>
<p>
NetBeans IDE 用于 C/C++ 项目的 Makefile 如下所示。
</p>
<img alt="NetBeans 用于 C/C++ 项目的 Makefile" class="margin-around" src="../../../images_www/articles/73/cnd/depchecking/makefiles.png">
<p>
<tt>Makefile</tt> 生成一次,您可以手动编辑它。不能手动编辑 <tt>nbproject</tt> 目录中的 Makefile;IDE 自动更新这些 Makefile。插图中的文件 <tt>Makefile-<i>CONF</i>.mk</tt> 表示所有项目配置的多个文件,例如 <tt>Makefile-Release.mk</tt><tt>Makefile-Debug.mk</tt> 等。
</p>
<p>
对于受管项目,IDE 将生成所有 Makefile 自身并插入正确的指令用于依赖关系检查。对于从现有源创建的项目,只有在现有 <tt>Makefile</tt> 包含此类指令时才会执行依赖关系检查,因为 NetBeans IDE 不会更改现有的 <tt>Makefile</tt>
</p>
<h2><a name="basics"></a>依赖关系生成基础知识</h2>
<p>
如果您希望 <tt>make</tt> 在构建期间检查包含的文件依赖关系,则必须将依赖关系信息插入到 <tt>Makefile</tt>。很遗憾,所有 <tt>make</tt> 实用程序和编译器都没有可移植方法可这么做。首先,您应检测哪个 <tt>make</tt> 正在运行,然后生成对应的依赖关系检查指令。
</p>
<p>
Oracle Solaris <tt>make</tt> 具有一种非常简单的解决方案。<tt>Makefile</tt> 中的特殊 <tt>.KEEP_STATE:</tt> 规则指示 <tt>make</tt> 在编译器中查询包含的文件依赖关系并将其存储在临时文件中。下次重新构建项目时,<tt>make</tt> 将加载该临时文件,分析该文件中存储的依赖关系,然后确定更改了哪些头文件以及应重新编译哪些对象文件。
</p>
<p>
对于 GNU <tt>make</tt>(称为 <tt>gmake</tt>),解决方案更加复杂。您必须明确请求编译器生成依赖关系信息,然后明确将这些信息包括到 <tt>Makefile</tt>。目的是向编译器传递特殊标志,以便编译器将为每个编译的源文件生成依赖关系信息。下次重新构建项目时,将收集依赖关系信息并包含到 <tt>Makefile</tt> 中。
</p>
<h2><a name="implementation"></a>实现</h2>
<p>
将以下代码添加到 <tt>nbproject/Makefile-impl.mk</tt> 中。它检测哪个 <tt>make</tt> 正在运行并将相应的依赖关系检查代码放入 <tt>.dep.inc</tt> 文件中。若存在 <tt>MAKE_VERSION</tt> 变量,则会检测到 GNU <tt>make</tt>。如果未设置 <tt>MAKE_VERSION</tt>,则会生成 Solaris <tt>make</tt> 特定的指令。
</p>
<pre class="examplecode"># dependency checking support
.depcheck-impl:
@echo "# This code depends on make tool being used" &gt;.dep.inc
@if [ -n "${MAKE_VERSION}" ]; then \
echo "DEPFILES=\$$(wildcard \$$(addsuffix .d, \$${OBJECTFILES}))" &gt;&gt;.dep.inc; \
echo "ifneq (\$${DEPFILES},)" &gt;&gt;.dep.inc; \
echo "include \$${DEPFILES}" &gt;&gt;.dep.inc; \
echo "endif" &gt;&gt;.dep.inc; \
else \
echo ".KEEP_STATE:" &gt;&gt;.dep.inc; \
echo ".KEEP_STATE_FILE:.make.state.\$${CONF}" &gt;&gt;.dep.inc; \
fi</pre>
<p>
将以下代码添加到 <tt>nbproject/Makefile-${CONF}.mk</tt> 中。它指示 <tt>make</tt> 读取以前生成的 <tt>.dep.inc</tt> 并执行其中的指令。
</p>
<pre class="examplecode"># Enable dependency checking
.dep.inc: .depcheck-impl
include .dep.inc</pre>
<p>
<tt>.dep.inc</tt> 不存在时,会添加规则 <tt>.dep.inc: .depcheck-impl</tt> 以防止构建失败。只有在从 "Projects"(项目)窗口编译单个文件时才会发生这种情况。在这种情况下,<tt>make</tt> 直接执行文件 <tt>nbproject/Makefile-${CONF}.mk</tt>
</p>
<h2>参考</h2>
<ol>
<li>
<a href="http://en.wikipedia.org/wiki/Make_%28software%29" target="_blank">关于 <tt>make</tt> 的 Wikipedia 文章</a>
</li>
<li>
<a href="http://make.paulandlesley.org/autodep.html" target="_blank">高级自动依赖关系生成</a>
</li>
</ol>
<h2>另请参见</h2>
<p>有关在 NetBeans IDE 中使用 C/C++/Fortran 进行开发的更多文章,请参见 <a href="https://netbeans.org/kb/trails/cnd.html">C/C++ 学习资源</a></p>
<div class="feedback-box"><a href="mailto:users@cnd.netbeans.org?subject=Feedback:%20Make%20Dependency%20Checking%20-%20NetBeans%20IDE%208.0%20Tutorial">发送有关此教程的反馈意见</a></div>
</body></html>