#windows #cargo #msvc

bin+lib cargo-xwin

Cross compile Cargo project to Windows MSVC target with ease

46 releases

0.16.4 Feb 1, 2024
0.16.3 Dec 20, 2023
0.16.0 Nov 22, 2023
0.14.6 Jul 11, 2023
0.7.1 Mar 11, 2022

#126 in Cargo plugins

Download history 5056/week @ 2023-11-09 4208/week @ 2023-11-16 4088/week @ 2023-11-23 5544/week @ 2023-11-30 5147/week @ 2023-12-07 4258/week @ 2023-12-14 3963/week @ 2023-12-21 4862/week @ 2023-12-28 5505/week @ 2024-01-04 5797/week @ 2024-01-11 6874/week @ 2024-01-18 5706/week @ 2024-01-25 6865/week @ 2024-02-01 6096/week @ 2024-02-08 6492/week @ 2024-02-15 11865/week @ 2024-02-22

32,490 downloads per month
Used in maturin

MIT license

877 lines


formerly cargo-xwinbuild

CI Crates.io docs.rs PyPI Docker Image

🚀 Help me to become a full-time open-source developer by sponsoring me on GitHub

Cross compile Cargo project to Windows msvc target with ease.

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


  1. For pure Rust project, no prerequisites needed.
  2. For C/C++ dependencies, install clang (On macOS run brew install llvm and you're good to go).
  3. For assembly dependencies, install llvm-tools-preview component via rustup component add llvm-tools-preview or install llvm.


cargo install cargo-xwin

You can also install it using pip:

pip install cargo-xwin

We also provide a Docker image which has wine pre-installed in addition to cargo-xwin and Rust, for example to build for 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. Install Rust Windows msvc target via rustup, for example, rustup target add x86_64-pc-windows-msvc
  2. Run cargo xwin build, for example, cargo xwin build --target x86_64-pc-windows-msvc

Run tests with wine

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


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

Environment Variable CLI option Description
XWIN_ARCH --xwin-arch The architectures to include, defaults to x86_64,aarch64, possible values: x86, x86_64, aarch, aarch64
XWIN_VARIANT --xwin-variant The variants to include, defaults to desktop, possible values: desktop, onecore, spectre
XWIN_VERSION --xwin-version The version to retrieve, defaults to 16, can either be a major version of 15 or 16, or a <major>.<minor> version
XWIN_CACHE_DIR --xwin-cache-dir xwin cache directory to put CRT and SDK files
XWIN_INCLUDE_DEBUG_LIBS --xwin-include-debug-libs Whether or not to include debug libs in installation (default false).

CMake Support

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

ninja is required to enable CMake support.


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


~692K SLoC