如何在Cargo build.rs中获取目标macOS的最低与最高支持版本

无需手动解析Clang内置的__MAC_OS_X_VERSION_MIN_ALLOWED、__MAC_OS_X_VERSION_MAX_ALLOWED宏，Cargo和系统工具已经将对应版本信息直接暴露给构建脚本，按以下逻辑实现即可：

• 最低兼容版本（对应__MAC_OS_X_VERSION_MIN_ALLOWED）直接读取Cargo传入的MACOSX_DEPLOYMENT_TARGET环境变量，该值为编译时指定的最低支持macOS版本，与C侧宏定义完全对齐。
• 编译用SDK版本（对应__MAC_OS_X_VERSION_MAX_ALLOWED）通过系统命令xcrun --sdk macosx --show-sdk-version获取，返回值即当前链接使用的Mac SDK版本号。

UniformTypeIdentifiers框架从macOS 11.0（Big Sur）开始提供，链接逻辑必须和依赖的C库条件编译规则保持一致：

绝大多数同类C库的判断逻辑为：SDK版本 >= 11.0时，会编译调用UniformTypeIdentifiers的代码路径；如果此时最低兼容版本 < 11.0，代码会内置运行时版本判断，旧系统自动走原有废弃实现，新系统才调用新框架接口。这种场景必须使用弱链接方式接入框架，否则旧系统启动时会因找不到框架直接崩溃。如果最低兼容版本本身 >= 11.0，直接正常链接即可。

可直接复用的build.rs代码如下：

use std::process::Command;

fn main() {
    // 非macOS目标直接跳过逻辑
    let target_os = std::env::var("CARGO_CFG_TARGET_OS").unwrap();
    if target_os != "macos" {
        return;
    }

    // 解析最低部署主版本号
    let min_version = std::env::var("MACOSX_DEPLOYMENT_TARGET")
        .unwrap_or_else(|_| "10.0".into());
    let min_major = parse_major_version(&min_version);

    // 获取当前使用的SDK主版本号
    let sdk_version = Command::new("xcrun")
        .args(["--sdk", "macosx", "--show-sdk-version"])
        .output()
        .ok()
        .and_then(|output| String::from_utf8(output.stdout).ok())
        .unwrap_or_else(|_| "10.0".into());
    let sdk_major = parse_major_version(&sdk_version);

    // SDK版本低于11.0时，C库不会编译UTI相关代码，无需链接
    if sdk_major < 11 {
        return;
    }

    if min_major >= 11 {
        // 最低支持版本 >=11.0，直接强链接框架
        println!("cargo:rustc-link-lib=framework=UniformTypeIdentifiers");
    } else {
        // 低版本兼容场景用弱链接，避免旧系统启动报错
        println!("cargo:rustc-link-arg=-weak_framework");
        println!("cargo:rustc-link-arg=UniformTypeIdentifiers");
    }
}

// 解析版本号主字段，兼容x.y.z格式
fn parse_major_version(ver: &str) -> u32 {
    ver.split('.')
        .next()
        .and_then(|v| v.parse().ok())
        .unwrap_or(0)
}

注意事项 #

• 版本对比必须拆分为整数比较，禁止直接用字符串对比，避免出现10.15字符串比较结果大于11.0的逻辑错误。
• 如果依赖的C库没有做运行时版本兼容，只要SDK版本>=11.0就直接调用UTI接口，直接判断min_major >= 11时再输出链接指令即可，低于11.0时C库会自动走旧实现路径，不会触发链接错误。
• 交叉编译场景下如果xcrun命令不可用，可手动从SDK路径提取版本号，常规本地编译场景上述逻辑可直接运行。

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