Cross compile Cargo project to Windows MSVC target with ease
Project description
cargo-xwin
formerly cargo-xwinbuild
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.8.6-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6898d296d0c9c1b143e5c5682ed91f9f44763739f2c108ed514e6b0cbb788c29 |
|
MD5 | 563c37b1405dd7fcaf19a2965ba19c4a |
|
BLAKE2b-256 | 6c179de5b1e23885c98d58041f674c31981a80940e033fe6f87eb2e8278746d3 |
Hashes for cargo_xwin-0.8.6-py3-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a34447c9a9da9ec79e12469dddedfc3f012dc50c6c24e8d44fde31bb767d0f63 |
|
MD5 | c7cc09a71156dd28b53478dec6c94519 |
|
BLAKE2b-256 | f0f55bb7257d260839e0d23034c213c3e8bc52af257b6873514215843b7c514b |
Hashes for cargo_xwin-0.8.6-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | dae82d80ae62f7414a1ae5579e27a69362507b3aa596a600d91758ceb65d3311 |
|
MD5 | 392c8fb0d8456eacb6f9505fa6e07589 |
|
BLAKE2b-256 | 5585a0e1f7b1ba9fe20331239b0b772ba256a43a62791524deded8eb77bc5b0b |
Hashes for cargo_xwin-0.8.6-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 831579fe1bfd7255862bbe9456db3153de7acd2ffc2cc45b568f1aedb29a9df0 |
|
MD5 | 0c9d2de6ff2699ff97bf3a2156064369 |
|
BLAKE2b-256 | dc6301faacd91b1450eaac92047e70313ce0bea6425da07c156fb32362bbf4e6 |
Hashes for cargo_xwin-0.8.6-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e767078d1394e76ebb862b3ba307b9f1087f6ec67eb5e0af8c7ba64d183b8fde |
|
MD5 | 77e20ca11060ee62227a663e4b7d1d11 |
|
BLAKE2b-256 | b72ba68eba1802a89a89ecb9601dc5e9b582421b8e0b6b8583d012aa5b2f83f8 |
Hashes for cargo_xwin-0.8.6-py3-none-manylinux_2_5_i686.manylinux1_i686.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 03e1d13b2d69a44f60ed7de99fd7ca5515e0676beb7bfba72035bb841f043c72 |
|
MD5 | 728700f48ad6319ec91d40c81a97202d |
|
BLAKE2b-256 | bc89b554ff364f18023ad27070e15437b13783b372ad36e2721f6fb0ef7f4eb0 |
Hashes for cargo_xwin-0.8.6-py3-none-macosx_10_9_x86_64.macosx_11_0_arm64.macosx_10_9_universal2.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 03cab057e093840cad75a8d814b3b7e2fed775b2104b8ff8724a808fa20c62b5 |
|
MD5 | 6076d34a1c72919db1872685e186eee1 |
|
BLAKE2b-256 | 162c37f14d7c5fd24ffc632de9b5cc415b0c0ee1c9e87f454bf7a260eca6dfe1 |