Dinghy

MIT/Apache 2 构建和测试

是什么？

Dinghy 是一个 cargo 扩展，用于将 cargo 工作流程应用于交叉编译场景。

Dinghy 特别适用于基于"小型"处理器的设备，如 Android 和 iOS 手机，或者树莓派等小型单板计算机。这些情况下，本地编译要么不可能，要么不切实际。

最初，Dinghy 的主要目标是测试和基准测试，但现在在 Snips 公司，我们用它来交叉编译整个平台。这包括在一个地方为 cc 和 pkg-config crate 设置舞台。

如果你是 Rust 库的作者，你可以在几分钟内在你的智能手机上运行测试和基准测试。 你应该至少偶尔这样做。

演示

让我们试试 BurntSushi 的 byteorder 如何在几个 arm 设备上处理 f32，包括两部智能手机和一个树莓派。

呼。它工作了。

如何使用？

一旦 dinghy 了解了你的工具链和设备，你就可以通过简单的 cargo 命令在任何 cargo 项目中运行测试和基准测试，大多数情况下无需修改它们。

只需在 cargo 和其子命令之间添加 dinghy -d some_device：

cargo dinghy -d my_android test
cargo dinghy -d my_raspberry bench

默认情况下，如果不使用 -d，Dinghy 将进行本地构建，就像 cargo 会做的那样。

入门

根据你的目标和工作站，设置 Dinghy 的难易程度可能会有所不同。

Android 相对容易，特别是如果你已经是移动开发者。
iOS 设置有很多步骤，但至少 Apple 提供了你所需的一切。同样，如果你是 iOS 开发者，大部分繁重的工作已经完成了。如果你不是，请注意你不需要支付任何费用。
其他可通过 ssh 访问的远程设备从 dinghy 的角度来看是最简单的，但你需要自己获取适用于你的设备架构和操作系统的工具链。如果你的设备是运行 raspbian 的树莓派，我们可以提供帮助。:)

高级主题和功能

一些项目需要资源文件来运行它们的测试或基准测试。Dinghy 尽最大努力使其在尽可能多的项目/目标配置中工作，但有些项目可能需要一些帮助。
在一些较大的项目中，你可能需要根据要测试的平台过滤项目成员。
有时向可执行文件传递环境变量可能会有用。
Dinghy 提供了一个覆盖系统，可以"添加"东西到你的工具链 sysroot。这允许你在不改变 sysroot 工具链的情况下，向构建依赖中添加"东西"，比如静态库或头文件。
dinghy-build crate 提供了一些在交叉编译环境中有用的 build.rs 功能。

仅使用 dinghy 作为运行器

如果你的项目已经可以在不使用 dinghy 的情况下为目标平台构建，而你只想使用 dinghy 在设备上运行代码，你可以直接使用 dinghy 的内置运行器。你只需要在 .cargo/config 中将 dinghy 注册为运行器。这里是针对所有 Apple 目标的示例：

[target.'cfg(all(any(target_arch="aarch64",target_arch="x86_64"),target_vendor="apple",any(target_os="ios",target_os="tvos",target_os="apple-watchos")))']
runner = "cargo dinghy runner --"

然后你可以直接使用 cargo test --target aarch64-apple-ios-sim 运行测试。

请注意，使用 dinghy 的推荐方式是作为 cargo 子命令，因为它会自动为你的项目设置许多必要的构建条件。

如果未传递平台（如上例所示），运行器将尝试自动检测平台。