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.16.5-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8c5c3a62195b851c49f46142d5da15752136b4db2292771d3e4dbda668aa698f |
|
MD5 | 85a1eb8e9a343ddf98901cd26968e24e |
|
BLAKE2b-256 | d3e686ec4e3a8ed46ee8eb41345155b4cccf8653602ef89a23558d7648fdb0f0 |
Hashes for cargo_xwin-0.16.5-py3-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 77716f5008bfaff823a35387d1613351fb364a9b77e6dcebe19b9f3278a7177f |
|
MD5 | 3b6345ff52dd678b8601bddfdccef55d |
|
BLAKE2b-256 | b6a20af119fdde91fc8870f6622b1e686c749d4b04952251d1cb67a71ddaec2e |
Hashes for cargo_xwin-0.16.5-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 182bb10d0f45bbd40066ce772f059810b10da427c18ef89542eb36dabdbfbb2d |
|
MD5 | aee55e1a56cd8dba0f68146b8aafa275 |
|
BLAKE2b-256 | d5473e53c626748a51e639f8f4ad1de525c0b6dfa980c8be62f6818a9d4a59b5 |
Hashes for cargo_xwin-0.16.5-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 063ab976f2ff3904677d94624ad0b27601e4aa9f8de6ca416bf0cacc0b890799 |
|
MD5 | 9c024ad344bf8383cbef8408f724ac95 |
|
BLAKE2b-256 | e2ddf02d5f789e9d2911e788e4640e03ef4c8e21e5cdf8a5b58c2824f9ae99dc |
Hashes for cargo_xwin-0.16.5-py3-none-manylinux_2_5_x86_64.manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 214f08630c5f6f9b08b3e729fb1173ea62cf7821f7bcadb2f48292897e84d6da |
|
MD5 | 301cca9a8d0f62d368265337ab34125b |
|
BLAKE2b-256 | 614e9f653227798d132b46e5c93d1575881fc290b0e16247ccb0f68024ca5400 |
Hashes for cargo_xwin-0.16.5-py3-none-manylinux_2_5_i686.manylinux1_i686.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 113b1eb927b30615ed5ceafa926b9646da3033cbec4bca9dccc233a07703f9a6 |
|
MD5 | 8e104859c513a1f19834c8194ccd4b1e |
|
BLAKE2b-256 | 79386597b6160c6a1670f22d10c4fa797ea69054f1e654505e914d76368d4e63 |
Hashes for cargo_xwin-0.16.5-py3-none-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | dfb4d57dd8de7de1546f3cf725f41592966bf3ced4d59053d22cde26579cf581 |
|
MD5 | b13885aa0b354e59cc8f944624bf8da0 |
|
BLAKE2b-256 | 3c63e79844e0b357c28d9b656d02d543c9bffb2bf6f96b6184756c1e2a32e4d4 |