如何用CMake的ExternalProject_Add下载、构建并正确链接Volk库？

核心问题分析 #

你遇到的错误主要源于两点：

• 路径不匹配：INSTALL_COMMAND指定的安装目录与代码中预设的库路径不一致，导致Ninja找不到生成的volk.lib。
• 依赖与时序问题：手动拼接的路径在CMake配置阶段就被解析，但Volk的构建安装是在构建阶段执行的；同时未正确将Vulkan依赖传递给Volk的构建过程。

修正后的完整配置 #

1. 先定位Vulkan依赖 #

Volk必须依赖Vulkan，先通过find_package找到Vulkan，确保Volk构建时能获取到必要的头文件和库：

find_package(Vulkan REQUIRED)

2. 正确配置ExternalProject_Add #

使用CMAKE_ARGS传递配置参数，避免手动写CONFIGURE_COMMAND导致的路径错误，同时指定明确的安装目录：

ExternalProject_Add(
    VolkDownload
    GIT_REPOSITORY https://github.com/zeux/volk.git
    GIT_TAG b3bc21e584f97400b6884cb2a541a56c6a5ddba3
    PREFIX ${PROJECT_SOURCE_DIR}/External/VolkDownload
    # 传递CMake配置参数，自动处理路径和依赖
    CMAKE_ARGS
        -DVOLK_INSTALL=ON
        -DCMAKE_INSTALL_PREFIX=<INSTALL_DIR>  # 自动映射到${PREFIX}/install
        -DVulkan_INCLUDE_DIR=${Vulkan_INCLUDE_DIR}
        -DVulkan_LIBRARY=${Vulkan_LIBRARY}
        -DCMAKE_BUILD_TYPE=Release
    # 多配置生成器（如Visual Studio）需指定配置类型
    BUILD_COMMAND cmake --build . --config Release
    INSTALL_COMMAND cmake --install . --config Release
)

3. 创建可复用的导入库目标 #

通过ExternalProject_Get_Property获取正确的安装目录，然后创建IMPORTED目标，并传递必要的接口属性（头文件、依赖库）：

# 获取Volk的安装目录
ExternalProject_Get_Property(VolkDownload install_dir)

# 创建全局导入库目标
add_library(volk STATIC IMPORTED GLOBAL)
# 确保Volk构建完成后再处理这个目标
add_dependencies(volk VolkDownload)

# 设置目标属性：库路径、头文件目录、依赖传递
set_target_properties(volk PROPERTIES
    IMPORTED_LOCATION "${install_dir}/lib/volk.lib"
    INTERFACE_INCLUDE_DIRECTORIES "${install_dir}/include"
    # 自动传递Vulkan依赖，无需手动在主目标中链接
    INTERFACE_LINK_LIBRARIES Vulkan::Vulkan
)

4. 链接主目标到Volk #

直接链接导入的volk目标，依赖关系会自动传递：

add_library(testLib SHARED ${SRC_FILES})
# 直接链接volk，头文件和Vulkan依赖会自动继承
target_link_libraries(testLib PRIVATE volk)

关键优化点说明 #

• 路径可靠性：使用<INSTALL_DIR>变量自动绑定安装目录，避免手动拼接相对路径导致的错误。
• 依赖传递：通过INTERFACE_LINK_LIBRARIES将Vulkan依赖附加到volk目标，主目标只需链接volk即可自动获得所有必要依赖。
• 时序控制：add_dependencies(volk VolkDownload)确保Volk构建完成后才会尝试访问其库文件，解决Ninja找不到文件的问题。

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