cargo-xwin

之前名为 cargo-xwinbuild

🚀 通过在 GitHub 上赞助我，帮助我成为全职开源开发者 赞助我

轻松将 Cargo 项目交叉编译为 Windows msvc 目标。

通过使用此软件，您同意接受位于 https://go.microsoft.com/fwlink/?LinkId=2086102 的许可证。

先决条件

1. 对于纯 Rust 项目，无需先决条件。
2. 对于 C/C++ 依赖项，安装 clang（在 macOS 上运行 brew install llvm 即可）。
3. 对于汇编依赖项，通过 rustup component add llvm-tools-preview 安装 llvm-tools-preview 组件或安装 llvm。

安装

cargo install --locked cargo-xwin

您也可以使用 pip 进行安装

pip install cargo-xwin

我们还提供了一个 Docker 镜像，其中预装了 wine、cargo-xwin 和 Rust，例如用于构建 x86_64 Windows。

docker run --rm -it -v $(pwd):/io -w /io messense/cargo-xwin \
  cargo xwin build --release --target x86_64-pc-windows-msvc

用法

1. 使用 rustup 安装 Rust Windows msvc 目标，例如，rustup target add x86_64-pc-windows-msvc
2. 运行 cargo xwin build，例如，cargo xwin build --target x86_64-pc-windows-msvc

使用 wine 运行测试

安装 wine 后，您可以使用 cargo xwin test 命令运行测试，例如，cargo xwin test --target x86_64-pc-windows-msvc

自定义

可以使用以下环境变量或命令行选项来自定义 Microsoft CRT 和 Windows SDK。

CMake 支持

一些 Rust crate 使用 cmake crate 来构建 C/C++ 依赖项，cargo-xwin 将自动生成 CMake 工具链 文件，以便交叉编译能够直接使用。

ninja 是必需的 以启用 CMake 支持。

许可协议

本作品采用 MIT 许可协议发布。许可协议的副本可在 LICENSE 文件中找到。