如何使用自动工具设置包含路径

我正在开发一个 C++ 项目，该项目使用autoconf & automake，我正在努力正确设置包含路径*CPPFLAGS。我读了大约3个小时的文档，但我还没有弄清楚。我不是在寻找黑客，而是在寻找正确的方法来做到这一点。这是我的难题。

据我所知，包含路径有 3 个完全不同的来源：

1. 必须与我的包一起安装的外部库，这些库由configure --with-XXX=<PATH>.
2. 在我的包中，一些源文件使用#include <file.h>即使当file.h是包的一部分，因此要编译它们，我必须正确设置包含路径。 （请注意，无法编辑所有这些文件。）
3. 异想天开的（或非异想天开的）标准指定必须允许用户指定他们自己的（额外的）包含路径。也就是说，我不应该设置CPPFLAGS at all.

在我当前的设置中：

• 内部设置类型1路径configure.ac by AC_SUBST(CPPFLAGS, "$CPPFLAGS -I<path>").
• 里面设置了2类路径Makefile.am by test_CPPFLAGS = -I<path>.
• 无法设置类型 3。更准确地说，如果用户设置CPPFLAGS跑步前make，这会覆盖类型 1 设置，导致编译失败。当然，用户可以尝试使用CXXFLAGS相反，但那个有不同的用途（记住，我要求的是正确的方法来做到这一点，而不是黑客）。

我尝试通过使用设置类型 1 路径来解决此问题AM_CPPFLAGS inside configure.ac。 （仅供参考：如果您设置AM_CPPFLAGS代替CPPFLAGS，但您仍然需要运行一些检查，例如AC_CHECK_HEADERS，需要临时设置CPPFLAGS然后将其恢复以使检查正常工作；这是解释的here http://www.bioinf.uni-freiburg.de/~mmann/HowTo/automake.html#extLibCheck.) 这释放了CPPFLAGS对于类型 3 路径，但不幸的是编译失败，因为Makefile-s 产生的configure只会使用AM_CPPFLAGS如果没有专门的<target>_CPPFLAGS存在。因此，如果test_CPPFLAGS存在类型 2 路径，编译test将会失败，因为它没有获得类型 1 路径。

修复方法是在内部指定Makefile.am总是使用AM_CPPFLAGS。但这是“按书本规定”吗？我可以以全局方式执行此操作，还是必须编辑每一个target_CPPFLAGS？还有另一个“正确”的解决方案吗？

我知道很难从自动工具手册中得到直接答案。有一些很好的从头到尾的教程here https://autotools.io/ and here http://www.freesoftwaremagazine.com/books/autotools_a_guide_to_autoconf_automake_libtool.

没有特定于包的标准变量*CPPFLAGS在自动配置中。configure可以调用CPPFLAGS=...，automake 会添加这个CPPFLAGS相关的 makefile 规则 - 搜索CPPFLAGS in a Makefile.in文件作为示例。出于这个原因，我建议你not将此变量用于其他用途。

添加标志Makefile.am to the AM_CPPFLAGS变量（所有预处理器调用的默认值）或覆盖单个预处理器标志target_CPPFLAGS。在第 3 方库的示例中，最好使用如下名称：FOO_CPPFLAGS保存预处理器选项，例如

FOO_CPPFLAGS="-I${FOO_DIR}/include -DFOO_BAR=1"
...
AC_SUBST(FOO_CPPFLAGS)

并在Makefile.am :

AM_CPPFLAGS = -I$(top_srcdir) $(FOO_CPPFLAGS)
# or:
target_CPPFLAGS = -I$(top_srcdir) $(FOO_CPPFLAGS)

The top_srcdir变量定义为configure- 我用它来说明第二种情况。假设你有file.h在另一个目录中other，在顶级目录下。-I$(top_srcdir)允许您将其包含为<other/file.h>。或者，-I$(top_srcdir)/other将允许您将其包含为<file.h>.

另一个有用的预设变量 http://www.gnu.org/software/autoconf/manual/autoconf.html#Preset-Output-Variables is srcdir- 当前目录。-I$(srcdir)被添加到AM_CPPFLAGS 默认情况下. So if file.h位于当前目录中，您可以将其包含在<file.h>甚至"file.h". If other是一个“兄弟”目录，-I$(srcdir)/..将允许你包括<other/file.h>, and -I$(srcdir)/../other会允许<file.h>.

我还要补充一点，一些软件包安装了 pkg-config.pc文件。如果 pkg-config 的安装设置为搜索正确的目录，您可能会发现PKG_CHECK_MODULES宏非常有用。