CARGO_ENCODED_RUSTFLAGS 的解析器

CARGO_ENCODED_RUSTFLAGS 是 Cargo 为构建脚本提供的环境变量之一。它综合了影响 Cargo 的 rustc 调用的多个标志来源

• 通过 RUSTFLAGS 环境变量传递的标志
• Cargo 配置条目在 target.<triple>.rustflags 和 target.<cfg>.rustflags 以及 build.rustflags 中，包括来自项目特定的 Cargo 配置文件和用户 CARGO_HOME 中的 Cargo 配置

如果构建脚本需要执行一些 rustc 调用，或者需要描述即将进行的 rustc 调用的某些方面，它可能需要这些标志。

[build-dependencies]
rustflags = "0.1"

示例

此构建脚本使用 cmake crate 编译一些 C 代码，如果 Rust 构建使用 sanitizers 进行，则必须使用特定的 C 预处理器 #define 来配置它。

// build.rs

use rustflags::Flag;
use std::env;
use std::path::PathBuf;

fn main() {
    let manifest_dir = PathBuf::from(env::var_os("CARGO_MANIFEST_DIR").unwrap());
    let lib_source_dir = manifest_dir.join("lib");
    assert!(lib_source_dir.join("CMakeLists.txt").exists());

    let mut builder = cmake::Config::new(lib_source_dir);

    // Look for -Zsanitizer=address
    for flag in rustflags::from_env() {
        if matches!(flag, Flag::Z(z) if z == "sanitizer=address") {
            builder.define("ENABLE_SANITIZERS", "ON");
            builder.define("SANITIZERS", "address");
            break;
        }
    }

    builder.build();
}

许可证