Cross compile Cargo project to Windows MSVC target with ease
Project description
cargo-xwin
formerly cargo-xwinbuild
🚀 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
Prerequisite
- For pure Rust project, no prerequisites needed.
- For C/C++ dependencies, install clang (On macOS run
brew install llvm
and you're good to go). - For assembly dependencies, install
llvm-tools-preview
component viarustup component add llvm-tools-preview
or install llvm.
Installation
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
Usage
- Install Rust Windows msvc target via rustup, for example,
rustup target add x86_64-pc-windows-msvc
- 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
Customization
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.
License
This work is released under the MIT license. A copy of the license is provided in the LICENSE file.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Hashes for cargo_xwin-0.15.0-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b8235a841b373df90af8dcbf60f3a67885b1cf26fefc175a1d2ba42d9d2c336b |
|
MD5 | 35c48d0d8975eded2fa7837961d8a533 |
|
BLAKE2b-256 | a298afecf638d558f692f7538fad63a1d2516699829385d012d78886b98c502a |
Hashes for cargo_xwin-0.15.0-py3-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ee83b91f080d4b37398088b109001ac314ed07605d5e60822ebb4f3426647a49 |
|
MD5 | 90b65b8d6633820e16e612ba925ebd9b |
|
BLAKE2b-256 | f60d47931bb3128b7f61b096a5048e2c7827a87258b6c02e25794283df82ed2f |
Hashes for cargo_xwin-0.15.0-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c157288a9974050eedea184d3968d86038ccda41e49bb04c8ac130dcb4cabe1c |
|
MD5 | 767e225b41888efa0f9e5a22f8d89bed |
|
BLAKE2b-256 | 044e348cef58666a4422b41aa94f82f45bb2d65c66662e722af988163bb8325e |
Hashes for cargo_xwin-0.15.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0fa5ec88c55660d4c96d5733b6d025232bb2b701e41cac766588030ec43849f5 |
|
MD5 | 6146b24b0808ac5d0101c981de4ae208 |
|
BLAKE2b-256 | 9725386368e4a1904c6e065d7fd1066259074bbf8c0c2f008a617cb176a3bd60 |
Hashes for cargo_xwin-0.15.0-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5d1ffa11288ad326ecbde99f5dafe70d5624b164b68bd1262a78d0515610eb61 |
|
MD5 | 2fd4caedfbf9ffe4a5ad6e3e79dd4878 |
|
BLAKE2b-256 | 840dd612fec34fa99b98f657fe2ac7ab99af2eba54d52134d53360e1a11d8b86 |
Hashes for cargo_xwin-0.15.0-py3-none-manylinux_2_5_i686.manylinux1_i686.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 048b706870c0e5fd3f866aff183caf63140285113b808fb6de37603af9c3e732 |
|
MD5 | 8f9e96a1313e0b6942b27f0f2a02bead |
|
BLAKE2b-256 | 46d4192ed04b71d1a4cc101849ae5074bf339d856bd0d4dd278f0939edcae987 |
Hashes for cargo_xwin-0.15.0-py3-none-macosx_10_9_x86_64.macosx_11_0_arm64.macosx_10_9_universal2.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 264617c19683e70141efb3c326b6b1326aa484cee43b3bb1f4b4e889eadfec01 |
|
MD5 | da049f6331d8dac2b89262e567dfa370 |
|
BLAKE2b-256 | e208ec31eb49898be8f0137ee1991ef35d5ac1126945bdbe6abeb49bab0e3aab |