cargo-zigbuild

CI Crates.io

Compile Cargo project with zig as linker.

Installation

bash cargo install cargo-zigbuild

Usage

  1. Install zig following the official documentation, on macOS, Windows and Linux you can also install zig from PyPI via pip3 install ziglang
  2. Install Rust target via rustup, for example, rustup target add aarch64-unknown-linux-gnu
  3. Run cargo zigbuild, for example, cargo zigbuild --target aarch64-unknown-linux-gnu

Specify libc version

cargo zigbuild supports passing libc version in --target option, for example, to compile for glibc 2.17 with the aarch64-unknown-linux-gnu target:

bash cargo zigbuild --target aarch64-unknown-linux-gnu.2.17

Limitations

Currently only Linux targets are supported, other target platforms can be added if you can make it work, pull requests are welcome.

Known upstream zig issues:

  1. cross-compiling to macOS with a dependency on iconv

License

This work is released under the MIT license. A copy of the license is provided in the LICENSE file.