Dinghy

是什么？

Dinghy 是一个 cargo 扩展，将 cargo 工作流程引入跨平台编译场景。

Dinghy 特别适用于“小型”基于处理器的设备，如 Android 和 iOS 手机，或小型单板计算机如 Raspberry Pi。在这些情况下，无法进行本地编译或不切实际。

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

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

演示

让我们尝试 BurntSushi 的 byteorder 在几个 arm 设备上处理 f32 的效果，包括两部智能手机和一个 Raspberry Pi。

哇。它工作正常。

如何？

一旦 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上的设置有很多步骤，但至少苹果提供了你所需的一切。再次提醒，如果你是iOS开发者，大部分繁重的工作已经完成。如果你不是，请注意你不需要支付任何费用。
• 从dinghy的角度来看，其他可通过SSH远程访问的设备是最容易的，但你需要自己获取设备架构和操作系统的工具链。如果你的设备是运行 raspbian 的树莓派，我们可以提供帮助。 :)

高级主题和功能

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

仅作为运行器使用dinghy

如果你的项目已经在没有dinghy的情况下为目标平台构建，你只想使用dinghy在设备上运行代码，你可以直接使用dinghy捆绑的运行器。你只需要在.cargo/config中将dinghy注册为运行器。以下是一个针对所有苹果目标的示例

[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子命令，因为它将为你的项目自动设置很多东西，以便甚至可以构建。

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

许可证

根据以下任一许可授权：

• Apache License，版本2.0（LICENSE-APACHE或https://apache.ac.cn/licenses/LICENSE-2.0）
• MIT许可证（LICENSE-MIT或http://opensource.org/licenses/MIT），任选其一。

贡献

除非你明确声明，否则任何提交给包括在你根据Apache-2.0许可证定义的作品中的贡献，都应如上所述双许可，不附加任何额外条款或条件。