最近在yocto项目中使用了add_custom_target
和 add_custom_command
,对两者的作用有所了解后,觉得还是很有必要做一个记录,希望可以帮到有需要的朋友。
add_custom_target
和 add_custom_command
是 CMake 中用于添加自定义构建步骤的两个关键命令。它们的主要区别在于其作用和用途。
1. add_custom_command
add_custom_command
用于向 CMake 添加自定义构建步骤。这个命令的主要作用是在构建目标(如可执行文件、库文件等)时执行一系列的命令。它通常用于在编译期间生成一些文件、复制文件、运行脚本等。
示例:
add_custom_command(
OUTPUT generated_file.txt
COMMAND echo "Generated content" > generated_file.txt
DEPENDS some_input_file.txt
COMMENT "Generating a file"
)
在这个例子中,add_custom_command
用于生成一个名为 generated_file.txt
的文件,内容为 “Generated content”。这个生成过程依赖于 some_input_file.txt
,并且在构建过程中输出一条 “Generating a file” 的注释。
2. add_custom_target
add_custom_target
用于添加自定义构建目标,这个目标通常不与实际的构建文件关联。它主要用于将一组自定义构建步骤组织成一个逻辑组,并在构建时执行这些步骤。这个命令通常与 add_custom_command
配合使用,以实现更复杂的构建过程。
示例:
add_custom_target(
my_custom_target
COMMAND echo "Hello from custom target"
DEPENDS generated_file.txt
COMMENT "Executing a custom target"
)
在这个例子中,add_custom_target
创建了一个名为 my_custom_target
的自定义构建目标,它执行一个命令,输出 “Hello from custom target”。这个目标依赖于前面 add_custom_command
中生成的 generated_file.txt
。
区别总结:
add_custom_command
主要用于定义在构建时执行的具体命令,通常与文件的生成或转换有关。add_custom_target
主要用于组织一组自定义构建步骤,并为它们创建一个逻辑目标。这个目标本身不与实际文件相关。
在实际使用中,这两个命令通常结合使用,以创建复杂的构建过程。例如,add_custom_command
生成文件,然后 add_custom_target
创建一个目标,该目标依赖于生成的文件,并可能执行一些其他操作。