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.10.3-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 60a42bbcd22c216e2b1a4935bf1720b678a7afeb4b503994f158210d2440b6f8 |
|
MD5 | 9708f5b121bb00efa1bb647fb0ca7714 |
|
BLAKE2b-256 | e7b990c70eee82ad6d3a7cf75c127f9d6fae9ce2f347e6d4b0f51181d070d115 |
Hashes for cargo_xwin-0.10.3-py3-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1c3ebbf587e6b7b5b63e73a60458a30af26e629564adb043cd06ea88968e1895 |
|
MD5 | 2a2a346c274a3739eb1da7eee29bba36 |
|
BLAKE2b-256 | 22fe98853b1daa7af2ea91904b2dcdf1c658b5095e4cea5979fa3f4439bf6a90 |
Hashes for cargo_xwin-0.10.3-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fd46e6abee587894d3e66aa7de0779b6e3bda78c5e60667858d853067773c3ff |
|
MD5 | f9d6707d19be9d8b8eda8cd7fa40bfce |
|
BLAKE2b-256 | 1d37cbe6fbdfd041df3549ae8089ca48e42dcad4b69e48e34d74d7d92a21a248 |
Hashes for cargo_xwin-0.10.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 704c312f8bc2709a96d7bb57ae9912cdefea15ba70d580d62f4677e10ab75709 |
|
MD5 | 2e1bca7fd68981de5ffce3cb2a0dc5e6 |
|
BLAKE2b-256 | 04e4d2b3aa6e3f6bf16f075e5589d818fb0cef0186b33cfef27d7dcfc92f88db |
Hashes for cargo_xwin-0.10.3-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6e762bc6b06344b97ce8dc303845b5b4dc91781ca592e60639f9cef363a8bedd |
|
MD5 | a803b4631d2724c6c0498b471850f80c |
|
BLAKE2b-256 | d2709ea17fc68e117c3088184177cfd22ee30cb7ed77d967127ed8651e94161d |
Hashes for cargo_xwin-0.10.3-py3-none-manylinux_2_5_i686.manylinux1_i686.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0ffd8746603a44f6eaddea89fcfc060396589e655a992b7ad2ce876dcb2fe2b4 |
|
MD5 | 5dfb4eb163dc17f301c6aaebc8afcb40 |
|
BLAKE2b-256 | 532f659cb25ffe45b11d0e37c60690ae11ff0a7311e5a3a1b9572b019c65f071 |
Hashes for cargo_xwin-0.10.3-py3-none-macosx_10_9_x86_64.macosx_11_0_arm64.macosx_10_9_universal2.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 96fabe44af8698ceffc308792b43b280402db182e7f69fa2fb429f23e6799d2b |
|
MD5 | d4844806eb2b206af203ef3039fb4f40 |
|
BLAKE2b-256 | 8ea8f22e9b214f4310acc59d9e7bd96d074e734a17e0adb40bb63f85476b9e8d |