Dinghy

是什么？

Dinghy 是一个 cargo 扩展，将 cargo 工作流引入交叉编译场景。

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

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

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

演示

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

哇。它工作了。

如何？

一旦Dinghy了解了你的工具链和设备，你将能够在任何 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 开发者，大部分的重活都已经有人帮你做了。如果你不是，请注意你不需要支付任何费用。
• 其他远程 SSH 可访问设备从 dinghy 的角度来看是最容易的，但你需要自己为你的设备架构和操作系统获取工具链。如果你的设备是运行 raspbian 的 Raspberry Pi，我们可以帮忙。 :)

高级主题和功能

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

仅作为运行器使用 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 许可证定义，应按上述方式双重许可，不附加任何额外条款或条件。