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.13.3-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 77ab2fd20d5e8f0da82242d523a1dafb74369191a6f8180adf09788536f9c598 |
|
MD5 | 5d6f0d35a6a9b03471698476540f80dd |
|
BLAKE2b-256 | 54dca9bdf23fe57e4a645700ba1978e591ddc9c51c798bc3dabcfefab77d8fb8 |
Hashes for cargo_xwin-0.13.3-py3-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 620f64a7958a726f5959d94a4cb5a34569f10a6c1dcb8b817bc6bedea0037e43 |
|
MD5 | 3dcc5bce43068823c6f894d392aef180 |
|
BLAKE2b-256 | 2683f64651c1701247302255a545e1365b7957bf0be976467f5b194b5ba7581d |
Hashes for cargo_xwin-0.13.3-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 408ccaa6786174225bf1ae81262fb92f0759094cc53c5c857d74d2719959d79c |
|
MD5 | 850946a4ee76b50eb47b81d4b30192c1 |
|
BLAKE2b-256 | e4a330831fca3c6bdcc0e4706bf592560476b45e73248ff811776632ad72ab86 |
Hashes for cargo_xwin-0.13.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a5da9a37e207185b8d9e2dff138b14c6e0508b958c550a196a85f4796a1a5ce9 |
|
MD5 | 15fcbe664b83adeb7e780b63cf086307 |
|
BLAKE2b-256 | fbd50f3a0a106f16722925683f45293a3acfc6e391b7988bcabcd542e3501a22 |
Hashes for cargo_xwin-0.13.3-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | acaeec52facdc80dda0a8547acea2ee2008036c9bcc8bee6a83fef4d123c3090 |
|
MD5 | a36b8a41b0acdd06989f10882f2904eb |
|
BLAKE2b-256 | 2f1ec6c09eaeb0fc4aecde969687bc83e85d427ec99696e5c6e5fe4be1d8eca8 |
Hashes for cargo_xwin-0.13.3-py3-none-manylinux_2_5_i686.manylinux1_i686.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bf68f8f6c76232c2ff94d7fcc4bf3e7bf6bbe075005f0c426aea4e3ce85ec2d4 |
|
MD5 | b0f23bc519e28eec3629ab8ccfd4fbf7 |
|
BLAKE2b-256 | 0e5eeab386ec18a811961c1c89b2d160bcca07d8d549e79d4e384ff9f76a4701 |
Hashes for cargo_xwin-0.13.3-py3-none-macosx_10_9_x86_64.macosx_11_0_arm64.macosx_10_9_universal2.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0d52bbb321c382eea65cd1d376da9209ecb857a1d153bb7be1d1e10eb6169e77 |
|
MD5 | 030865c547c52ad8ec229bd465be1b62 |
|
BLAKE2b-256 | 328a4265183fd80f33e47419b20636b9a9d7286b7a7b65bd204849f2f0d313be |