ffx 工具

ffx 为主机目标互动提供了一个统一的 Fuchsia CLI 工具平台。它为许多常见的开发和集成工作流操作引入了面向服务的接口，用户可能希望针对一个或多个 Fuchsia 目标设备执行这些操作。

它既是服务运行时，也是实用程序集合，适用于用户和基础设施集成商。

面向用户的入门指南

首先，请参阅有关如何使用 ffx 工具的用户指南。

开发者入门

在为 ffx 扩展或添加子工具时，请务必考虑以下事项：

  • ffx 是用 Rust 开发的，大量使用了 Rust crate。不过，箱必须托管在 Fuchsia 平台源代码树中。 开源审核委员会 (OSRB) 流程文档中详细介绍了此流程。查看 third_party/rust_crates 中的现有箱子。

  • 在扩展 ffx 时，请运行 ffx help 查看现有命令界面，了解新命令或工具可能适合的位置。

  • 在扩展现有命令时，请考虑添加标志或选项。不过，如果启用的总体工作流不存在，请考虑使用新命令或更高级别的子分组。

  • 考虑工具所依赖的 FIDL 服务、本地文件系统条目、目标文件系统路径或任何清单/清单格式等依赖项。

  • 考虑一下该命令如何与多部设备互动。ffx 提供了一个全局 --target 来明确声明要与哪个设备互动。

  • 该命令是否需要访问配置或依赖于特定的构建环境？如果是，请充分利用 ffx 中的各种配置设置，或为特定命令或工作流定义新的配置设置。可通过 ffx config get 访问现有配置。

如需查看包含示例的详细指南，请参阅为 FFX 开发。

CLI

命令行界面 (CLI) 为 ffx 提供用户体验。它负责：

  • 解析用户参数（CLI 参数）
  • 将已解析的参数和请求的 FIDL 代理路由到正确的代码路径以供执行

远程控制服务

远程控制服务在目标设备上运行，负责提供对目标设备上运行的 FIDL 服务的访问权限。

FDomain

FDomain 是一种机制，用于从开发宿主机与 Fuchsia 目标设备上的 FIDL 服务进行通信。它旨在取代 Overnet 协议。如需了解详情，请参阅 FDomain 概览。