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.12.0-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8b7881321026dd83d62cb87ac3259e1bd88bd15f642e187a58a6a871951432e9 |
|
MD5 | 798b8d80cbf139e32b55e6c565178206 |
|
BLAKE2b-256 | b5ca8765b0cef38b85a9ca46a40cfea6b869d641a54669c6f20753504171e0ff |
Hashes for cargo_xwin-0.12.0-py3-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b7eeabe45b36f69253318fca050aa8462aa4a8a9ffc8740919993e62e76ee8a2 |
|
MD5 | 01fe1281a9a911e1b1ae63a29ab190cf |
|
BLAKE2b-256 | ee118f88d52c61e86e47c343961b47f2f032ea660e9d17ccd9fe4a5e59ad4281 |
Hashes for cargo_xwin-0.12.0-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b3e5d72a7028da541c4b374e9679569cd191f2d9ec2577287350338b436918de |
|
MD5 | 015135d6c321e32545e895a9c9296346 |
|
BLAKE2b-256 | acfb55770e69270c157314b4c696ba5f5bc3e5f4522b1d4788c37e168e63bbb6 |
Hashes for cargo_xwin-0.12.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8b3682173a71375420f8b4037d31da79f491719510270baeb9561072c89efba1 |
|
MD5 | 47c84e639ff370b67cdef40c61dbeab5 |
|
BLAKE2b-256 | 5f1758a9bbc44deb5e500b0f549d8628ac990d87db369f0f02f79ea777eafbf8 |
Hashes for cargo_xwin-0.12.0-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 19575e192efe5ac1aa434fdcee8464249d6444628f7e8fa6866a6af282624deb |
|
MD5 | 26d1d71d74e328113b79a230f1de4c31 |
|
BLAKE2b-256 | 1d0f59875420d86825e47a565f233562e00a297ac5e8f94166f86a33ca622d16 |
Hashes for cargo_xwin-0.12.0-py3-none-manylinux_2_5_i686.manylinux1_i686.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a58ab3f0f225e5cce73a7a4d4dbb775aa920764e0d98aa8ef58cb055617100d4 |
|
MD5 | 60dcc9c39db8805be40f4d7cb19999ca |
|
BLAKE2b-256 | c22e307c7d8acca0fe8ff3abb47f92ae04b5106f9433fd1967d9a8d26165d475 |
Hashes for cargo_xwin-0.12.0-py3-none-macosx_10_9_x86_64.macosx_11_0_arm64.macosx_10_9_universal2.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1aff34a8381e4bfe032da653e68990a7978ef90ceaa8cb2bdecfddf57bae75da |
|
MD5 | 5ec403f04b1b0f7aeee43288b8365dab |
|
BLAKE2b-256 | a998b3cc6b915e9b0a6ae86b99ec99dc3855cc8801d9fe8eab611e425445b482 |