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.
- 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.0-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d611545053bbdf1e0bf94d79186d962fa59a2c7f2609077219afcf29384b23e9 |
|
MD5 | b2827b939d802e90e6868f9b28e1581c |
|
BLAKE2b-256 | 0823a85077bba2fedeb17397cbcc40a1b56994f9a8f2b82138938e055d6e8080 |
Hashes for cargo_xwin-0.13.0-py3-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 22e0ec0f7993323c73823f7e4051534f40a82d45884c6ae91aac389ab0ab7a74 |
|
MD5 | 52be12042a089252cc86ef3541db3302 |
|
BLAKE2b-256 | f6a9f733fcfbfa50e65cdb6a528f74b8bfc67033c534173b7f8fe0c2923b265e |
Hashes for cargo_xwin-0.13.0-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bf7e6c652704d46355b85c157c99d6c28e96eab329f6a551ebef6622441c2748 |
|
MD5 | b1b5d47a34a17b982753c3753bef85a1 |
|
BLAKE2b-256 | a8271614002596fb1556704c25fd0dc87ade10d107759679d040c21244f895f1 |
Hashes for cargo_xwin-0.13.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8e9c8d44ecfb27ba929b9a7ce69f3502a36a83e4a953b32bbe7d879160f806fa |
|
MD5 | c2b70f78e37914e1b28b618160ad3875 |
|
BLAKE2b-256 | 8b2fce03c42f87bb5fe7fce23da3c8f02a4b036b8043f33846e1d163750a6740 |
Hashes for cargo_xwin-0.13.0-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9ff90243725f4572896507ebf7bb4fbdb36d4951f80de4c6b2f66dcfac10ead2 |
|
MD5 | 1eef87ef7b97b2c509bdf86502ce899b |
|
BLAKE2b-256 | f79ad455cdc8c3aeaee3cad7a2399f67dc556912d0a5229e1f41befc1b9d35a3 |
Hashes for cargo_xwin-0.13.0-py3-none-manylinux_2_5_i686.manylinux1_i686.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 82c345f5b830a060ef65ca31be87ed060ded870aeae3887bab0ede7caae4ba72 |
|
MD5 | 834b56412411694b9a1317f7fe23f6de |
|
BLAKE2b-256 | cbcd11235734ac94d1166ddd28b047b43808ecbdc13ecffa60430f6ab32677ae |
Hashes for cargo_xwin-0.13.0-py3-none-macosx_10_9_x86_64.macosx_11_0_arm64.macosx_10_9_universal2.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f8a0b445f87470411a84cb04e73781daa895825acadf855f17fa739098b4b505 |
|
MD5 | 01e39544795f9dd2550333848eb254c0 |
|
BLAKE2b-256 | 9cf351740db9624a05adc9dd908467f1fc1e1697fe123ace9d31aad4be4327fa |