CMake是一个跨平台的安装（编译）工具，它可以自动化软件编译过程。CMake的一个强大功能是允许用户使用
add_custom_command
来创建自定义命令。这个功能使得开发者能够执行各种复杂的编译和安装任务，而这些任务可能无法通过CMake内置的命令直接完成。
什么是add_custom_command？
add_custom_command
是一个CMake命令，它允许你定义一个自定义的命令，这个命令可以在构建过程中被调用。它通常用于执行一些需要特定工具或脚本的复杂任务。
使用add_custom_command的基本语法
add_custom_command(
OUTPUT
COMMAND
DEPENDS
COMMENT “Optional message”
[WORKING_DIRECTORY
[VERBATIM]
[COMMENT]
[BYPRODUCTS
)
OUTPUT
：指定生成的文件列表，这些文件将作为自定义命令的输出。
COMMAND
：指定要执行的命令。
DEPENDS
：指定依赖文件或命令，这些文件或命令在执行自定义命令之前必须存在或执行。
COMMENT
：提供一条可选的消息，用于在CMake输出中显示。
WORKING_DIRECTORY
：指定工作目录，命令将在该目录下执行。
BYPRODUCTS
：指定生成的副产品文件列表。
实例：使用add_custom_command创建一个简单的脚本
假设我们有一个需要编译的源文件，我们想要创建一个自定义脚本，该脚本在编译源文件之前先运行一个预处理脚本。
# 定义输出文件
set(OUTPUT_FILE my_output)
# 定义预处理脚本和编译命令
set(PREPROCESS_SCRIPT pre_process.sh)
set(COMPILE_COMMAND g++ ${SOURCE_FILE} -o ${OUTPUT_FILE})
# 使用add_custom_command创建自定义命令
add_custom_command(
OUTPUT ${OUTPUT_FILE}
COMMAND ${PREPROCESS_SCRIPT}
COMMAND ${COMPILE_COMMAND}
DEPENDS ${SOURCE_FILE} ${PREPROCESS_SCRIPT}
COMMENT “Running pre-process and compile script”
)
在这个例子中，我们首先定义了输出文件
my_output
，然后设置了预处理脚本和编译命令。接着，我们使用
add_custom_command
来创建一个自定义命令，该命令首先运行预处理脚本，然后编译源文件。
高级用法：多阶段构建和复杂依赖
add_custom_command
也可以用于更复杂的场景，比如多阶段构建和复杂依赖。
多阶段构建
add_custom_command(
OUTPUT ${OUTPUT_FILE}
COMMAND ${CMAKE_COMMAND} -E make_directory ${STAGE_DIR}
COMMAND ${CMAKE_COMMAND} -E copy ${SOURCE_FILE} ${STAGE_DIR}
COMMAND ${CMAKE_COMMAND} -E echo “Building stage 1”
COMMAND ${CMAKE_COMMAND} -E echo “Building stage 2”
DEPENDS ${SOURCE_FILE}
COMMENT “Setting up multi-stage build”
)
在这个例子中，我们首先创建了一个目录，然后将源文件复制到该目录中。接下来，我们执行了两个简单的命令来模拟多阶段构建过程。
复杂依赖
add_custom_command(
OUTPUT ${OUTPUT_FILE}
COMMAND ${CMAKE_COMMAND} -E touch ${OUTPUT_FILE}
DEPENDS ${SOURCE_FILE}
COMMENT “Creating a file with a complex dependency”
)
在这个例子中，我们创建了一个文件，其依赖项是一个源文件。这个例子展示了如何使用
add_custom_command
来创建具有复杂依赖关系的文件。
总结
add_custom_command
是CMake的一个非常强大的功能，它允许开发者执行各种复杂的构建任务。通过理解其用法和语法，你可以解锁CMake的更多潜力，从而创建更灵活、更强大的构建系统。