cross

“零配置”的Rust crate交叉编译与“交叉测试”

本项目由 https://github.com/cross-rs 团队开发和维护。此前由 Rust 嵌入式工作组工具团队维护。欢迎新贡献者！请加入我们的 [Matrix 房间] 打个招呼。

为 aarch64-unknown-linux-gnu 目标对 crate 进行 cross test

特性

• cross 会提供交叉编译所需的所有组件，无需修改您的系统安装。
• cross 提供环境、交叉工具链和交叉编译库，可生成最具可移植性的二进制文件。
• “交叉测试”：cross 可针对 i686 和 x86_64 以外的架构测试 crate。
• 支持 stable、beta 和 nightly 频道。

依赖项

有关详细安装说明，请参见我们的 入门指南。

• rustup
• 交叉测试需要支持 binfmt_misc 的 Linux 内核。

需要以下容器引擎之一。如果两者都已安装，cross 将默认使用 docker。

• Docker。> [!NOTE] Linux 上的非 sudo 用户需要加入 docker 用户组或使用 rootless docker。有关所需的安装和安装后步骤，请阅读容器引擎 https://github.com/cross-rs/cross/wiki/Getting-Started#installing-a-container-engine。需要 20.10 版本（API 1.40）或更高版本。
• Podman。需要 3.4.0 版本或更高版本。

安装

cargo install cross --git https://github.com/cross-rs/cross

也可以直接下载预编译的 https://github.com/cross-rs/cross/releases 或使用 https://github.com/cargo-bins/cargo-binstall%E3%80%82

使用方法

cross 拥有与 https://github.com/rust-lang/cargo 完全相同的 CLI，但依赖 Docker 或 Podman。对于 Docker，您需要先启动守护进程才能使用。

#（Linux 上每次启动时执行一次）
# 如果 Docker 守护进程未运行，使用 systemd 启动它
# 在 WSL2 和其他使用 SysVinit 的系统上，使用 `sudo service docker start`。
$ sudo systemctl start docker

# 神奇！这能直接运行
$ cross build --target aarch64-unknown-linux-gnu

# 更神奇！这也能直接运行
$ cross test --target mips64-unknown-linux-gnuabi64

# 显然，这同样能直接运行
$ cross rustc --target powerpc-unknown-linux-gnu --release -- -C lto

更多文档可在 https://github.com/cross-rs/cross/wiki 或 docs/ 子文件夹中找到。

调试

QEMU_STRACE（v0.1.9+）

使用 cross run 时，您可以设置 QEMU_STRACE 变量，以获取来自“外部”（非 x86_64）二进制文件的系统调用回溯。

$ cargo new --bin hello && cd $_

$ QEMU_STRACE=1 cross run --target aarch64-unknown-linux-gnu
9 brk(NULL) = 0x0000004000023000
9 uname(0x4000823128) = 0
(..)
9 write(1,0xa06320,14)Hello, world!
= 14
9 sigaltstack(0x4000823588,(nil)) = 0
9 munmap(0x0000004000b16000,16384) = 0
9 exit_group(0)

最低支持的 Rust 版本 (MSRV)

本 crate 保证可在稳定版 Rust 1.85.0 及更高版本上编译。它可能也能在旧版本上编译，但这在任何新的补丁版本中都可能发生变化。

某些交叉编译目标需要更高版本的 Rust，且使用 Xargo 需要 nightly Rust 工具链。