cargo-xwinbuild

Cross compile Cargo project to Windows msvc target with ease. (LLVM installation required.)

By using this software you are consented to accept the license at https://go.microsoft.com/fwlink/?LinkId=2086102

Installation

cargo install cargo-xwinbuild

You can also install it using pip:

pip install cargo-xwinbuild

Usage

1. Install LLVM, on macOS: brew install llvm
2. Install Rust Windows msvc target via rustup, for example, rustup target add x86_64-pc-windows-msvc
3. Run cargo xwinbuild, for example, cargo xwinbuild --target x86_64-pc-windows-msvc

Run tests with wine

With wine installed, you can run tests with the cargo xwintest command, for example, cargo xwintest --target x86_64-pc-windows-msvc

Customization

The Microsoft CRT and Windows SDK can be customized using the following environment variables or CLI options.

CMake Support

Some Rust crates use the cmake crate to build C/C++ dependencies, cargo-xwinbuild will generate a CMake toolchain file automatically to make cross compilation work out of the box.

ninja is required to enable CMake support.

License

This work is released under the MIT license. A copy of the license is provided in the LICENSE file.