aux_source_directory

aux_source_directory

在目录中查找所有源文件。

aux_source_directory(<dir> <variable>)

收集指定目录中所有源文件的名称，并将列表存储在提供的变量中。 该命令旨在供使用显式模板实例化的项目使用。 模板实例化文件可以存储在Templates子目录中，并使用此命令自动收集，以避免手动列出所有实例化。

试图使用此命令来避免编写库或可执行目标的源文件列表。 尽管这似乎可行，但是CMake无法生成知道何时添加新源文件的生成系统。 通常，生成的构建系统知道何时需要重新运行CMake，因为修改了CMakeLists.txt文件以添加新的源。 当仅将源代码添加到目录而不修改该文件时，将不得不手动重新运行CMake来生成包含新文件的构建系统。

翻译自官方文档，原文链接为：aux_source_directory

使用示例

CMake 入门实战提供的示例程序以及对应的CMakeLists.txt示例有aux_source_directory的使用。

同一目录，多个源文件

对应的源代码所在目录：Demo2
之前的例子只有单个源文件。现在假如把 power 函数单独写进一个名为 MathFunctions.c 的源文件里，使得这个工程变成如下的形式：

./Demo2
    |
    +--- main.cc
    |
    +--- MathFunctions.cc
    |
    +--- MathFunctions.h

这个时候，CMakeLists.txt 可以改成如下的形式：

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)

# 项目信息
project (Demo2)

# 指定生成目标
add_executable(Demo main.cc MathFunctions.cc)

唯一的改动只是在 add_executable 命令中增加了一个 MathFunctions.cc 源文件。这样写当然没什么问题，但是如果源文件很多，把所有源文件的名字都加进去将是一件烦人的工作。更省事的方法是使用 aux_source_directory 命令，该命令会查找指定目录下的所有源文件，然后将结果存进指定变量名。其语法如下：

aux_source_directory(<dir> <variable>)

因此，可以修改 CMakeLists.txt 如下：

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)

# 项目信息
project (Demo2)

# 查找当前目录下的所有源文件
# 并将名称保存到 DIR_SRCS 变量
aux_source_directory(. DIR_SRCS)

# 指定生成目标
add_executable(Demo ${DIR_SRCS})

这样，CMake 会将当前目录所有源文件的文件名赋值给变量 DIR_SRCS，再指示变量 DIR_SRCS 中的源文件需要编译成一个名称为 Demo 的可执行文件。

参考资料

• aux_source_directory
• CMake 入门实战
• CMake Tutorial