如何在CMake中选择ExternalProject_Add的构建目标并跨平台链接？

当然可行！这其实是用CMake管理外部依赖时非常常见的需求，我来给你拆解一下具体怎么做，分两种场景来说，你可以根据外部项目的情况选合适的方式。

第一步：让ExternalProject只构建你需要的目标 #

默认情况下，ExternalProject_Add会构建外部项目的ALL目标，也就是所有目标。要指定只构建target1和target2，你可以通过BUILD_COMMAND参数覆盖默认的构建命令，用CMake的跨平台构建语法适配不同生成器（比如Makefile、Ninja、Visual Studio）：

ExternalProject_Add(
    ext_mylib  # 给外部项目起个本地标识名
    GIT_REPOSITORY https://example.com/your-external-lib.git  # 替换成你的依赖仓库地址
    GIT_TAG v1.0.0  # 替换成你需要的版本/tag
    SOURCE_DIR ${CMAKE_CURRENT_BINARY_DIR}/mylib-src
    BINARY_DIR ${CMAKE_CURRENT_BINARY_DIR}/mylib-build
    INSTALL_COMMAND ""  # 如果不需要安装外部项目，直接跳过这一步
    # 关键：指定只构建target1和target2
    BUILD_COMMAND ${CMAKE_COMMAND} --build . --target target1 target2 --config $<CONFIG>
)

这里的$<CONFIG>是CMake的生成器表达式，会自动适配当前的构建配置（Debug/Release等），保证跨平台和多配置场景下的兼容性。

第二步：将外部目标导入本地项目，实现可移植链接 #

接下来要解决的是如何像链接本地目标一样用target_link_libraries，而不是硬编码库文件路径。这里分两种情况：

场景1：外部项目不是CMake项目（或未导出CMake目标） #

如果外部项目没有用CMake构建，或者没有提供CMake配置文件，我们可以手动创建导入库目标，把外部构建好的库文件关联进来：

# 先获取外部项目的构建目录
ExternalProject_Get_Property(ext_mylib BINARY_DIR)

# 创建target1的导入库目标
add_library(target1 STATIC IMPORTED GLOBAL)
set_target_properties(target1 PROPERTIES
    # 根据外部项目的实际路径调整，这里假设Debug和Release库在不同子目录
    IMPORTED_LOCATION_DEBUG "${BINARY_DIR}/debug/libtarget1.a"  # Linux/macOS静态库
    # IMPORTED_LOCATION_DEBUG "${BINARY_DIR}/debug/target1.lib"  # Windows静态库
    IMPORTED_LOCATION_RELEASE "${BINARY_DIR}/release/libtarget1.a"
    # IMPORTED_LOCATION_RELEASE "${BINARY_DIR}/release/target1.lib"
    # 指定头文件目录，让你的项目能找到外部库的头文件
    INTERFACE_INCLUDE_DIRECTORIES "${CMAKE_CURRENT_BINARY_DIR}/mylib-src/include"
)

# 同样处理target2
add_library(target2 STATIC IMPORTED GLOBAL)
set_target_properties(target2 PROPERTIES
    IMPORTED_LOCATION_DEBUG "${BINARY_DIR}/debug/libtarget2.a"
    IMPORTED_LOCATION_RELEASE "${BINARY_DIR}/release/libtarget2.a"
    INTERFACE_INCLUDE_DIRECTORIES "${CMAKE_CURRENT_BINARY_DIR}/mylib-src/include"
)

# 关联依赖：确保先构建外部项目，再构建我们的导入目标
add_dependencies(target1 ext_mylib)
add_dependencies(target2 ext_mylib)

现在你就可以直接用熟悉的方式链接了：

target_link_libraries(mytarget PRIVATE target1 target2)

场景2：外部项目是CMake项目（推荐） #

如果外部项目本身用CMake构建，并且支持导出CMake目标（安装时会生成<LibName>Config.cmake这类文件），那我们可以用更优雅的方式：让外部项目安装到本地目录，然后用find_package导入目标。

首先修改ExternalProject_Add的配置，让它安装到一个临时目录：

ExternalProject_Add(
    ext_mylib
    GIT_REPOSITORY https://example.com/your-cmake-based-lib.git
    GIT_TAG v1.0.0
    SOURCE_DIR ${CMAKE_CURRENT_BINARY_DIR}/mylib-src
    BINARY_DIR ${CMAKE_CURRENT_BINARY_DIR}/mylib-build
    INSTALL_DIR ${CMAKE_CURRENT_BINARY_DIR}/mylib-install  # 指定本地安装目录
    # 传递CMake参数，指定安装前缀和构建类型
    CMAKE_ARGS -DCMAKE_INSTALL_PREFIX=<INSTALL_DIR> -DCMAKE_BUILD_TYPE=$<CONFIG>
    # 构建指定目标并执行安装
    BUILD_COMMAND ${CMAKE_COMMAND} --build . --target target1 target2 install --config $<CONFIG>
)

然后在你的项目中导入外部项目的CMake目标：

# 设置CMake前缀路径，让find_package能找到外部项目的配置文件
set(mylib_DIR ${CMAKE_CURRENT_BINARY_DIR}/mylib-install/lib/cmake/mylib)  # 路径要和外部项目的导出路径匹配
# 导入外部项目的target1和target2
find_package(mylib REQUIRED COMPONENTS target1 target2)

# 直接链接，就像本地目标一样
target_link_libraries(mytarget PRIVATE mylib::target1 mylib::target2)

这种方式完全遵循CMake的现代依赖管理规范，不需要手动指定库文件路径，兼容性和可维护性更好。

一些注意事项 #

• 如果是动态库，Windows下需要额外设置IMPORTED_IMPLIB属性（导入库文件），并且要确保运行时能找到动态库文件（可以通过CMAKE_INSTALL_RPATH等方式设置）。
• 多配置生成器（比如Visual Studio）下，要确保外部项目的构建配置和你的主项目一致，$<CONFIG>会帮你自动处理这一点。
• 如果外部项目的目标路径有特殊结构，你可能需要调整IMPORTED_LOCATION的路径，最好先手动构建一次外部项目，确认库文件的生成位置。

内容的提问来源于stack exchange，提问作者Gontran Zipper