执行依赖关系检查

本教程将向您演示如何允许 NetBeans IDE 在构建时检查项目中的文件依赖关系。由 make 实用程序通过 Makefile 中的指令执行依赖关系检查。

目录

此页上的内容适用于 NetBeans IDE 7.3、7.4 和 8.0

要求

要学习本教程,您需要具备以下软件和资源。

软件 要求的版本
NetBeans IDE(支持 C/C++) 带有 NetBeans C/C++ 插件的版本 7.3、7.4 或 8.0
Java 开发工具包 (JDK) 版本 7 或 8

有关下载并安装所需软件的信息,请参见 NetBeans IDE 安装说明配置 NetBeans IDE 以使用 C/C++/Fortran

简介

大的 C/C++ 项目包含数千个文件。例如,Linux 内核大约有 20,000 个文件。如果您开发的是这样一个项目并且希望在进行小的更改(例如,一行修复)之后重新构建该项目,则可以选择以下两个选项。

  • 完全重新构建(“清除”和“构建”操作)。这样做比较慢,但会保证一致的构建结果。
  • 增量重新构建(“构建”操作)。这样做比较快,但能否正确重新构建所有应重新构建的内容?

增量重新构建的主要问题在于存在 #include 指令,这些指令将一个文件的内容包含到另一个文件。包含的文件称为“文件依赖关系”。修改包含的文件应视为修改包含该文件的所有文件。间接包含(A 包含 B,B 包含 C => A 包含 C)使问题更加复杂。

NetBeans IDE 支持自动检查文件依赖关系并尽可能使增量重新构建正常工作。如果更改包含到某些源文件的头文件,然后单击“构建”,则 IDE 将仅重新构建那些真正依赖于所更改头文件的项目部分。此功能可节省时间并保证一致的构建结果。

为项目启用依赖关系检查

可控制各个特定项目的依赖关系检查。您可能需要确保启用该功能。

为项目启用依赖关系检查:

  1. 右键单击 "Projects"(项目)窗口中的项目,然后选择 "Properties"(属性)。
  2. 在 "Project Properties"(项目属性)对话框中,选择 "Categories"(类别)列表中的 "Build"(构建)节点。
  3. 在构建属性中,选中 "Enable Make Dependency Checking"(启用 Make 依赖关系检查)对应的复选框。

项目属性中的 "Make Dependency Checking"(Make 依赖关系检查)复选框

默认情况下为新项目启用依赖关系检查

可以设置依赖关系检查的默认状态,以便自动为您创建的新项目启用 Make 依赖关系检查。

为在 IDE 中创建的所有新项目启用依赖关系检查:

  1. 在 IDE 主菜单中选择 "Tools"(工具)> "Options"(选项)。
  2. 单击顶部窗格中的 "C/C++" 按钮。
  3. 单击 "Project Options"(项目选项)标签。
  4. 选中 "Enable dependency checking in generated makefiles"(在生成的 makefile 中启用依赖关系检查)对应的复选框

NetBeans 选项中的 "Dependency checking"(依赖关系检查)复选框

  • 自动依赖关系检查适用于在 IDE 中创建的 C/C++ 项目(受管项目)。IDE 将依赖关系检查逻辑构建到生成的 Makefile。对于使用现有源创建的项目,必须依赖于现有 Makefile 中的依赖关系检查逻辑(如果有)。
  • 依赖关系检查需要来自工具集合(make 和编译器)的支持。依赖关系检查已经过 Oracle Solaris Studio 工具集合和 GNU 工具集合(包含 Cygwin 和 MinGW)的测试。
  • 当 Oracle Solaris Studio 编译器与 Oracle Solaris make 一起使用时以及当 GNU 编译器与 GNU gmake 一起使用时,将执行依赖关系检查。不支持混合 Oracle Solaris make 与 GNU 编译器,反之亦然。

本文的其余内容是面向那些想要知道 IDE 背后执行的操作的高级用户。

构建过程(make 和 makefile)

Makefilemake 实用程序所理解的特殊格式的文件)中描述了 NetBeans 中每个 C/C++ 项目的构建过程。从 GUI 构建或清除项目时,IDE 将调用 make 以执行 Makefile。通过这种方法,您可以在 IDE 外部使用 make 轻松构建项目:只需转到您的项目目录并键入 make help 即可获得指令。

NetBeans IDE 用于 C/C++ 项目的 Makefile 如下所示。

NetBeans 用于 C/C++ 项目的 Makefile

Makefile 生成一次,您可以手动编辑它。不能手动编辑 nbproject 目录中的 Makefile;IDE 自动更新这些 Makefile。插图中的文件 Makefile-CONF.mk 表示所有项目配置的多个文件,例如 Makefile-Release.mkMakefile-Debug.mk 等。

对于受管项目,IDE 将生成所有 Makefile 自身并插入正确的指令用于依赖关系检查。对于从现有源创建的项目,只有在现有 Makefile 包含此类指令时才会执行依赖关系检查,因为 NetBeans IDE 不会更改现有的 Makefile

依赖关系生成基础知识

如果您希望 make 在构建期间检查包含的文件依赖关系,则必须将依赖关系信息插入到 Makefile。很遗憾,所有 make 实用程序和编译器都没有可移植方法可这么做。首先,您应检测哪个 make 正在运行,然后生成对应的依赖关系检查指令。

Oracle Solaris make 具有一种非常简单的解决方案。Makefile 中的特殊 .KEEP_STATE: 规则指示 make 在编译器中查询包含的文件依赖关系并将其存储在临时文件中。下次重新构建项目时,make 将加载该临时文件,分析该文件中存储的依赖关系,然后确定更改了哪些头文件以及应重新编译哪些对象文件。

对于 GNU make(称为 gmake),解决方案更加复杂。您必须明确请求编译器生成依赖关系信息,然后明确将这些信息包括到 Makefile。目的是向编译器传递特殊标志,以便编译器将为每个编译的源文件生成依赖关系信息。下次重新构建项目时,将收集依赖关系信息并包含到 Makefile 中。

实现

将以下代码添加到 nbproject/Makefile-impl.mk 中。它检测哪个 make 正在运行并将相应的依赖关系检查代码放入 .dep.inc 文件中。若存在 MAKE_VERSION 变量,则会检测到 GNU make。如果未设置 MAKE_VERSION,则会生成 Solaris make 特定的指令。

# dependency checking support
.depcheck-impl:
	@echo "# This code depends on make tool being used" >.dep.inc
	@if [ -n "${MAKE_VERSION}" ]; then \
	    echo "DEPFILES=\$$(wildcard \$$(addsuffix .d, \$${OBJECTFILES}))" >>.dep.inc; \
	    echo "ifneq (\$${DEPFILES},)" >>.dep.inc; \
	    echo "include \$${DEPFILES}" >>.dep.inc; \
	    echo "endif" >>.dep.inc; \
	else \
	    echo ".KEEP_STATE:" >>.dep.inc; \
	    echo ".KEEP_STATE_FILE:.make.state.\$${CONF}" >>.dep.inc; \
	fi

将以下代码添加到 nbproject/Makefile-${CONF}.mk 中。它指示 make 读取以前生成的 .dep.inc 并执行其中的指令。

# Enable dependency checking
.dep.inc: .depcheck-impl

include .dep.inc

.dep.inc 不存在时,会添加规则 .dep.inc: .depcheck-impl 以防止构建失败。只有在从 "Projects"(项目)窗口编译单个文件时才会发生这种情况。在这种情况下,make 直接执行文件 nbproject/Makefile-${CONF}.mk

参考

  1. 关于 make 的 Wikipedia 文章
  2. 高级自动依赖关系生成

另请参见

有关在 NetBeans IDE 中使用 C/C++/Fortran 进行开发的更多文章,请参见 C/C++ 学习资源

get support for the NetBeans

Support


By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2015, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo