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.14.8-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 427256533270eb54264ab19972146e3f539523584cc12f40d147a240647f68f2 |
|
MD5 | 61a8c327608ad14eff47b03f1f955ed7 |
|
BLAKE2b-256 | f53591e382f2fd400343e1f2b398104787e35241075dbd192f791c77e2b56d43 |
Hashes for cargo_xwin-0.14.8-py3-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d3a13d5ca68bc9ff4d9e3c7b9ce16082201319b4d90c3bce1959f1b8e1626dc8 |
|
MD5 | 2029dfbedcb51c4d90c10fcd99d4c8b5 |
|
BLAKE2b-256 | 16629f1c473573fb6198bb2d67062df1c102c6acd036e86096e81e8a1923e2ab |
Hashes for cargo_xwin-0.14.8-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | eaf1a95776bb7186a36aba52eda4d18e382c6cddf590db69bc2deac2545b944f |
|
MD5 | 3b7d16ef6ef39eec46c17aee4788a8e8 |
|
BLAKE2b-256 | a71cfcc11eaa57d07c09b0855baaf72d11b3d79923d93bf50d16d4b66d0d1030 |
Hashes for cargo_xwin-0.14.8-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0ef3ddbe62d701ce5fa43332048d1903be85520fbf4611368eb12ebf400b5a5f |
|
MD5 | 41b4d24a952b334d4d51177085b30b79 |
|
BLAKE2b-256 | 43c22e0185706e4564c40bbb56b518292cf64d0d6c3335ac1355cf78e92bdf82 |
Hashes for cargo_xwin-0.14.8-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2039dbc4fdf81c4657c13735e46a8b9122becc181440dd874aacf24029bb016f |
|
MD5 | 5da3809405ff847493c79fc04821f09b |
|
BLAKE2b-256 | 111bcca706de276e68a06e76de84dee29d0708fd90e7ffbfba1a1a1a15f32d64 |
Hashes for cargo_xwin-0.14.8-py3-none-manylinux_2_5_i686.manylinux1_i686.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c7bb04ef68bc5b8c72d5bc255e75061ac7d1c54cd9dc6c75edfc462bc5bf49ee |
|
MD5 | 2172136af164a725daa19e3a4f4623f5 |
|
BLAKE2b-256 | 774dbfb3ed84603dbee28924960b3ab37cfa8d4070dc462c8bc1af899119b2a5 |
Hashes for cargo_xwin-0.14.8-py3-none-macosx_10_9_x86_64.macosx_11_0_arm64.macosx_10_9_universal2.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7fbd08ded15c51fc4a3d756e1f2391e0294f536f14c7f68f8a7f6df87d550521 |
|
MD5 | 0c0f3a8edef63acc710a023ae2941a66 |
|
BLAKE2b-256 | 0a6b877223c45defa27e9afff7fa95443c9b9eaa09b91e195628ac9dffa39f51 |