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 |
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.7-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a58be538369e2730ef3d8ba4ed82d57cc37124da93dcd7e248931e2aa7c6bd87 |
|
MD5 | 3e606c00ad140f8d36a9ddf3ce6ab496 |
|
BLAKE2b-256 | 7ac344e3d82079a729c5b65be09987cdf0fc73f1b10866449402d277efaeffaf |
Hashes for cargo_xwin-0.14.7-py3-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c6c9af3f141474c8bcab9b17b28a1a13a4f034dff123531291396120f767d7e3 |
|
MD5 | c5d962e548cf55893e01c26f1e4f6a67 |
|
BLAKE2b-256 | fe5dfa794f055995981abba1c9f16634c9996e363cc3fea80ff4b5e411d52042 |
Hashes for cargo_xwin-0.14.7-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 35c5a14d68c58aab8e5ae006303e5291cf5c17ec38a5ddca00d8aa07a02bb482 |
|
MD5 | 0cf47f65b9dcf9af02a54a58ce483a96 |
|
BLAKE2b-256 | 1c51af4f7066a57eb99fca44180d6702fd58fcdd594e70ce179492e859b333aa |
Hashes for cargo_xwin-0.14.7-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5fde471bd68541feae79c861f339d8db99cddcdbd85f666f73d6fb33602ae958 |
|
MD5 | cbcc71d32e0d4896ce12b6214399db7f |
|
BLAKE2b-256 | 35929fef23a604c461a89ea4777c31be9feec33ecef7b6989a8f2d656d5aa8b7 |
Hashes for cargo_xwin-0.14.7-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2b003e249e21a7b3e3303981599739b9e52fcbea7133116cc215fd849b444749 |
|
MD5 | 3d045cc574a7d412550c6e15e7a47388 |
|
BLAKE2b-256 | 1c852278e13fd5ec31b0834e4dc796764dd1a3c658d336fb4ee2c01318056b10 |
Hashes for cargo_xwin-0.14.7-py3-none-manylinux_2_5_i686.manylinux1_i686.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cc8a44ac9ae3f96cb93aac6a4515b3d3c885239850c7910f57b1de957a0458b1 |
|
MD5 | 8675ded00aa7cba22e81c49ace5e2054 |
|
BLAKE2b-256 | 2d59b25b24de791ba25ca4c2c4cd38369efca783dce520e6c454080e356f5adc |
Hashes for cargo_xwin-0.14.7-py3-none-macosx_10_9_x86_64.macosx_11_0_arm64.macosx_10_9_universal2.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2e4242faee6bb9bbf58ebff0c4b2febd02ed8dc862d3a90f03f758765afa3af1 |
|
MD5 | 914e9989aea4d85ab5d1c222c6c0bc7a |
|
BLAKE2b-256 | 752f8040d23689246d423bcff8578000e1fa7842ab8a1489ec05ace07ec461a1 |