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.16.0-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8f7819f2b2b35178cdce9b1958e81f675d89e0b85460a1b4086aff77792d73c9 |
|
MD5 | a05c094bbd242975c56b1afb4578c549 |
|
BLAKE2b-256 | 783ac93c0b9dca0df73310ad9358216bf5a71cba47e64699e3e179ddc61c8354 |
Hashes for cargo_xwin-0.16.0-py3-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bda48229876faf86784e77417aa6a6f13d564a34b747b7633bf10861fe646461 |
|
MD5 | 5fdc413bc63916ebf1a8aa03cf33952f |
|
BLAKE2b-256 | 1a1dfece731d38860593e4d74201f668a7ff5ab14e4107ccab01705ffd39f02d |
Hashes for cargo_xwin-0.16.0-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3975e538e5f034fe51b9930669ad30e4fd62ac6a1b304a99fb02415146fabf18 |
|
MD5 | 9fa9b2975471d967555cfd508bcb3021 |
|
BLAKE2b-256 | d425f8ffe44be78597a1cf1b1378b16eb2ed6f49ad1c814f050ffead0752ae6c |
Hashes for cargo_xwin-0.16.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2d32f7ce08d2d2316ea0c4ede35300a7a7d59ee1dc644cfb657bcfdc8dab26e0 |
|
MD5 | cc03593e3917a647614cde6382af9840 |
|
BLAKE2b-256 | 83aed4d34b51017ecdab61f6e3cf27115d5b4af3a4d578691076d8a94ad4f6e7 |
Hashes for cargo_xwin-0.16.0-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 16caed331e65cc90be89bcd329b2d131ac7b51951227a57f79b54658d02491a1 |
|
MD5 | f45de6dbe3418b9e8cbda0fa6a2fd5a3 |
|
BLAKE2b-256 | 1de2f6118b0529353e6d16c692e8226e7130eaa9ed6fdabc670b7c110da15725 |
Hashes for cargo_xwin-0.16.0-py3-none-manylinux_2_5_i686.manylinux1_i686.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a3632db1a3721f27331ba6517ff2ec5112cb8063f30dd0ae7b2058085c92582e |
|
MD5 | 461752bdbb585faeea620f1013e57248 |
|
BLAKE2b-256 | 36e9707e04eff28a5f7196903bf9d3b920afbf9d8aa81c49e88bc1c0f98572d7 |
Hashes for cargo_xwin-0.16.0-py3-none-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 77e2027b2c3f55ef71ca25ad0d5d39586116cb92f2846de2b87dd8ccb1f2f63f |
|
MD5 | 136096e01eace3831ec122efd0ee5ddd |
|
BLAKE2b-256 | 0b97eedfcb70f9187de0092a689761dac53841e6b5ca53b980ba228de6f2891d |