如何在Rust Cargo中传递CMake构建的C++库的链接依赖？

针对你遇到的C++依赖（比如OpenEXR）链接标志无法传递给Rust项目的问题，目前常用的几种实践方案如下：

1. 让CMake输出链接信息文件，在build.rs中解析使用 #

修改你的C++库（spikes）的CMakeLists.txt，在构建完成后生成包含链接依赖信息的文本文件，然后在Rust的build.rs中读取并输出对应的Cargo指令。

步骤： #

• 在spikes的CMakeLists.txt末尾添加以下内容，生成链接标志文件：

# 生成包含OpenEXR链接信息的文件
file(WRITE ${CMAKE_BINARY_DIR}/spikes_deps_link.txt "
rustc-link-search=native:${OpenEXR_LIBRARY_DIR}
rustc-link-lib=static:OpenEXR
")

（注：${OpenEXR_LIBRARY_DIR}是CMake中找到的OpenEXR库路径，具体变量名需根据spikes的CMake配置调整）

• 在build.rs中构建完spikes后，读取该文件并输出Cargo指令：

let dst = cmake::Config::new(spikes).build();

// 读取CMake生成的链接依赖文件
let link_file = dst.join("spikes_deps_link.txt");
if let Ok(content) = std::fs::read_to_string(link_file) {
    for line in content.lines().filter(|l| !l.trim().is_empty()) {
        let (directive, value) = line.split_once(':').unwrap();
        println!("cargo:{}={}", directive, value);
    }
}

2. 使用pkg-config直接探测系统依赖 #

如果OpenEXR是通过包管理器安装的系统库，可以用pkg-config crate直接获取其链接信息，无需依赖CMake传递。

步骤： #

• 在Cargo.toml中添加pkg-config依赖：

[build-dependencies]
pkg-config = "0.3"

• 在build.rs中添加探测代码：

// 探测OpenEXR的链接信息
if let Ok(exr_lib) = pkg_config::Config::new().probe("OpenEXR") {
    // 输出库搜索路径
    for path in exr_lib.link_paths {
        println!("cargo:rustc-link-search=native={}", path.display());
    }
    // 输出需要链接的库
    for lib_name in exr_lib.libs {
        println!("cargo:rustc-link-lib=static={}", lib_name);
    }
}

3. 在cxx_build链路上直接添加依赖参数 #

因为你用cxx_build编译C桥接代码，可以直接将依赖的链接标志添加到cxx_build的配置中，让它负责处理C代码的链接依赖。

修改build.rs中的cxx_build部分：

cxx_build::bridge("src/imageio_cxx.rs")
    .file("external/imageio-bridge.cpp")
    .include(spikes_includes)
    .flag_if_supported("-std=c++17")
    // 添加OpenEXR的链接参数（根据实际路径调整）
    .flag("-L/path/to/openexr/lib")
    .flag("-lOpenEXR")
    .compile("libimageio-bridge");

注意事项 #

• 跨平台适配：不同平台的链接标志有差异，比如Windows下需要指定.lib文件路径，macOS可能需要用-framework标志，建议结合cfg!(target_os)做条件判断。
• 静态/动态链接：如果要静态链接依赖库，确保获取到的是静态版本的库文件，并且传递static关键字给rustc-link-lib。

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