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 |
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.14.1-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9a86032defdf76ebf34bc626b15f58cad6f68745b19d42806fa74b16682f5885 |
|
MD5 | 39f0dab2bd4fd51c824e86c3d4bb3587 |
|
BLAKE2b-256 | a4ca18d7ae53b3ec282c3ec2ff93568c9d41d9dcd789285eb96c220e2d5040d3 |
Hashes for cargo_xwin-0.14.1-py3-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 38a6673e47d8fe49c9cc9a7f5ed5e2f181707beb4607f0d03c89356349b63944 |
|
MD5 | 901f30530af832b8b8f0059e4ec05406 |
|
BLAKE2b-256 | 12d10cbd026a514cce51f4134efb39aa13c1434316ede232790b40d53cd0c09f |
Hashes for cargo_xwin-0.14.1-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a947178d0a2817ff044feb4ec00f613f0d75be4e48a5dd36a8435d9630f488c3 |
|
MD5 | 91358ed232c4115acc60c4087855fc31 |
|
BLAKE2b-256 | 05fd541871aadc4e2fb8ecf3a248619f1051d00e41017b7335a5acf4bd611668 |
Hashes for cargo_xwin-0.14.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9b875b27849662ae55ae38206c2345f2988e0680c3a9cfd2a23b56b0d930b5ec |
|
MD5 | 1cc66f7bbd996ce15d57d28fa18ecbfd |
|
BLAKE2b-256 | 8cdd340011837d91dcfc7f96ed270064c808bcfd944c6161b059617332f56599 |
Hashes for cargo_xwin-0.14.1-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4b538a069b5692da55905c60d44953f3df41c7af8a71daa2db278277d03dacb9 |
|
MD5 | dc20d836a2243641f979085c89fd9abb |
|
BLAKE2b-256 | a6f5717e602e69d618552c08bc9bb780c8293a44d65b6360885a89513206f40d |
Hashes for cargo_xwin-0.14.1-py3-none-manylinux_2_5_i686.manylinux1_i686.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6b53f488336da12c8f14c48f5d4bed59238908d0b09f1ec4c6fd2a3b0ff8e4b9 |
|
MD5 | dade5dc6ef5c01791dc986be454bb5f2 |
|
BLAKE2b-256 | 2e7ea7944cb85e4c84655b50769def84afad1e38ee21a85df2a751c21e28a5e0 |
Hashes for cargo_xwin-0.14.1-py3-none-macosx_10_9_x86_64.macosx_11_0_arm64.macosx_10_9_universal2.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f562d250af2f86a4eaec730fd6c478bc0661b03e439fe8ef7880fcf7d08f66c4 |
|
MD5 | 81a289aa45cfe0f45d4859255db7ca3c |
|
BLAKE2b-256 | 2b38c61a5c83b1e790626bb05ad1e2acfc1e7e5841b4f12e237f15e8810125c9 |