Rust静态链接VC运行时库static_vcruntime的使用，解决Windows平台Rust程序依赖VC运行时的部署问题

Rust静态链接VC运行时库static_vcruntime的使用，解决Windows平台Rust程序依赖VC运行时的部署问题

使用方法

在项目的Cargo.toml中添加构建依赖：

[build-dependencies]
static_vcruntime = "2.0"

然后创建或修改build.rs构建脚本：

fn main() {
    // 调用static_vcruntime的metabuild函数实现静态链接
    static_vcruntime::metabuild();
}

完成上述配置后，使用以下命令构建release版本即可实现静态链接：

cargo build --release

问题解决

如果遇到构建问题，可以尝试以下解决方法：

  1. 清理构建目录后重新构建：
cargo clean
  1. 如果仍然存在问题，可以创建.cargo/config.toml文件并添加：
[target.'cfg(all(windows, target_env = "msvc"))']
rustflags = ["-C", "target-feature=+crt-static"]

完整示例

1. 创建新项目

cargo new static_vcruntime_example
cd static_vcruntime_example

2. 编辑Cargo.toml

[package]
name = "static_vcruntime_example"
version = "0.1.0"
edition = "2021"

[build-dependencies]
static_vcruntime = "2.0"

3. 创建build.rs构建脚本

// build.rs
fn main() {
    // 启用静态链接VC运行时库
    static_vcruntime::metabuild();
}

4. 编写主程序

// src/main.rs
fn main() {
    println!("这是一个静态链接VC运行时的Rust程序示例");
}

5. 构建发布版本

cargo build --release

6. 验证依赖关系

使用以下命令检查生成的exe文件是否依赖vcruntime140.dll：

dumpbin /dependents target/release/static_vcruntime_example.exe

如果配置成功，输出中将不再显示对vcruntime140.dll的依赖。


1 回复

Rust静态链接VC运行时库static_vcruntime的使用指南

介绍

在Windows平台上使用Rust开发的程序通常依赖于Microsoft Visual C++(VC)运行时库。默认情况下，Rust会动态链接这些库，这意味着目标机器上必须安装相应版本的VC运行时库才能运行你的程序。static_vcruntime是一个解决此问题的方案，它允许你将VC运行时库静态链接到你的Rust程序中，从而消除对目标机器上VC运行时库的依赖。

使用方法

1. 添加依赖

首先，在你的Cargo.toml文件中添加static_vcruntime作为构建依赖：

[build-dependencies]
static_vcruntime = "2.0.0"

2. 创建build.rs文件

在你的项目根目录下创建一个build.rs文件（如果还没有的话），并添加以下内容：

extern crate static_vcruntime;

fn main() {
    static_vcruntime::metabuild();
}

3. 配置目标平台

确保你的目标平台是Windows（这通常是默认情况）：

[package]
# ...
[target.'cfg(windows)'.build-dependencies]
static_vcruntime = "2.0.0"

4. 构建项目

现在当你使用cargo build构建项目时，VC运行时库将被静态链接到你的可执行文件中。

高级配置

指定VC运行时版本

你可以指定要链接的VC运行时版本：

fn main() {
    static_vcruntime::metabuild_with_vcruntime(static_vcruntime::VCRuntime::VCRuntime140);
}

可用的版本选项包括：

  • VCRuntime120 (VS2013)
  • VCRuntime140 (VS2015/2017/2019/2022)
  • VCRuntime141 (VS2017/2019/2022)

调试版本

对于调试构建，你可能需要链接调试版本的运行时库：

fn main() {
    #[cfg(debug_assertions)]
    static_vcruntime::metabuild_with_vcruntime(static_vcruntime::VCRuntime::VCRuntime140Debug);
    
    #[cfg(not(debug_assertions))]
    static_vcruntime::metabuild_with_vcruntime(static_vcruntime::VCRuntime::VCRuntime140);
}

验证静态链接

构建完成后，你可以使用以下方法验证VC运行时是否已静态链接：

  1. 使用dumpbin工具：

    dumpbin /DEPENDENTS your_program.exe

    如果输出中没有VCRUNTIME140.dll之类的依赖项，说明静态链接成功。

  2. 在没有安装VC运行时的干净Windows机器上运行你的程序，应该能够正常运行。

注意事项

  1. 静态链接会增加最终可执行文件的大小。
  2. 确保你的项目中所有依赖项都兼容静态链接VC运行时。
  3. 如果你使用其他需要VC运行时的C库，也需要确保它们配置为静态链接。

完整示例代码

以下是完整的静态链接VC运行时库的Rust项目示例：

项目结构

static_vcruntime_demo/
├── Cargo.toml
├── build.rs
└── src/
    └── main.rs

Cargo.toml

[package]
name = "static_vcruntime_demo"
version = "0.1.0"
edition = "2021"

# 添加构建依赖
[build-dependencies]
static_vcruntime = "2.0.0"

# 确保只针对Windows平台
[target.'cfg(windows)'.build-dependencies]
static_vcruntime = "2.0.0"

build.rs

// 引入static_vcruntime crate
extern crate static_vcruntime;

fn main() {
    // 使用默认的VC运行时版本进行静态链接
    // 对于调试版本可以使用VCRuntime140Debug
    #[cfg(debug_assertions)]
    static_vcruntime::metabuild_with_vcruntime(static_vcruntime::VCRuntime::VCRuntime140Debug);
    
    // 对于发布版本使用普通版本
    #[cfg(not(debug_assertions))]
    static_vcruntime::metabuild_with_vcruntime(static_vcruntime::VCRuntime::VCRuntime140);
}

src/main.rs

fn main() {
    // 简单的演示程序
    println!("这个程序已经静态链接了VC运行时库");
    println!("你可以在没有安装VC运行时的机器上运行它！");
    
    // 演示使用C标准库功能
    let nums = vec![1, 2, 3, 4, 5];
    println!("数字总和: {}", nums.iter().sum::<i32>());
}

构建和验证

  1. 使用以下命令构建项目：

    cargo build --release

  2. 验证静态链接是否成功：

    dumpbin /DEPENDENTS target\release\static_vcruntime_demo.exe

    输出中不应包含VCRUNTIME140.dll等依赖项。

  3. 在没有安装VC运行时的Windows机器上测试程序是否能正常运行。

通过这个完整示例，你可以创建一个不依赖外部VC运行时库的Windows Rust程序，简化部署过程。

回到顶部