windres-rs

windres 是一个用于在构建时将 Windows 资源 (.rc) 文件 编译成目标文件（然后传递给链接器）的 Rust 库 crate。这允许将图标、版本信息、本地 UI 数据等嵌入由 Rust 代码编译的二进制文件中。

示例

以下示例演示了如何将图标嵌入二进制 crate 中

// hello-world.rc

1 ICON "hello-world.ico"

// build.rs

extern crate windres;

use windres::Build;

fn main() {
    Build::new().compile("hello-world.rc").unwrap();
}

用法

为了使 windres 工作正常，您需要为目标 ABI 安装资源编译器。目前支持的编译器如下：

• windres.exe 用于 GNU 目标（包含在 mingw-w64 工具链中）
• rc.exe 用于 MSVC 目标（包含在 Windows SDK 中，可通过 Visual Studio 安装程序安装）

一旦安装了适当的资源编译器，请在 Cargo.toml 中将 windres 添加为构建依赖项

[target.'cfg(windows)'.build-dependencies]
windres = "0.2"

然后，创建一个构建脚本（如果尚未创建），并添加对 windres 的引用

#[cfg(windows)]
extern crate windres;

许可证

根据您选择以下任一项进行许可：

• Apache 许可证 2.0 版本，(LICENSE-APACHE 或 http://apache.ac.cn/licenses/LICENSE-2.0)
• MIT 许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

任选其一。

贡献

除非您明确表示，否则根据 Apache-2.0 许可证定义的，您提交的任何有意包含在工作中的贡献，都应按上述方式双重许可，不得附加任何额外条款或条件。