cmake add_dependencies指令详解

add_dependencies 指令用于在 CMake 构建系统中指定目标之间的依赖关系。通过定义依赖关系，CMake 可以确保在构建某个目标之前，所有依赖的目标都已构建完成。

语法

add_dependencies(<target> <dependency> [<dependency>...])

• target: 这是一个已有的 CMake 目标，可以是 add_executable、add_library 或 add_custom_target 定义的目标。
• dependency: 一个或多个该目标依赖的其他目标。每个依赖项在构建 之前都必须被构建。

示例

1. 简单依赖:

add_executable(my_executable main.cpp)
add_library(my_library my_library.cpp)

# Ensure my_library is built before my_executable
add_dependencies(my_executable my_library)

在这个例子中，my_executable 依赖于 my_library，这意味着在构建 my_executable 之前，CMake 将先构建 my_library。

2. 自定义目标依赖:

add_custom_target(my_custom_target ALL
    COMMAND echo "Building custom target"
)

add_executable(my_executable main.cpp)

# Ensure my_custom_target is executed before my_executable
add_dependencies(my_executable my_custom_target)

在这个例子中，my_custom_target 是一个自定义目标，不生成任何文件，但在构建 my_executable 之前需要先执行该目标的命令。

注意事项

• add_dependencies 仅影响构建顺序，并不会直接影响链接顺序。如果需要控制链接顺序或链接依赖库，应该使用target_link_libraries 指令。
• 如果你在一个大的项目中定义了多个目标，使用 add_dependencies可以帮助你更好地管理构建顺序，确保所有目标按照正确的顺序构建。 通过正确使用add_dependencies，你可以确保项目的构建过程符合你的预期，并避免因为构建顺序错误而导致的潜在问题。