ffx 提供統一平台,方便主機目標互動使用 Fuchsia CLI 工具。針對使用者可能想對一或多個 Fuchsia 目標裝置執行的許多常見開發和整合工作流程作業,這項工具提供以服務為導向的介面。
這項工具既是服務執行階段,也是公用程式的集合,適用於使用者和基礎架構整合人員。
使用者入門指南
請先參閱使用者指南,瞭解如何使用 ffx 工具。
開發人員入門指南
擴充或新增 ffx 的子工具時,請務必考量下列事項:
ffx是以 Rust 開發,並大量使用 Rust Crate。不過,Crate 必須託管在 Fuchsia 平台來源樹狀結構中。如要瞭解詳情,請參閱開放原始碼審查委員會 (OSRB) 的程序文件。查看third_party/rust_crates中的現有 Crate。擴充
ffx時,請執行ffx help檢視現有指令介面,瞭解新指令或工具可能適用的位置。擴充現有指令時,請考慮新增旗標或選項。 不過,如果沒有啟用整體工作流程,請考慮使用新指令或更高層級的子群組。
請考量依附元件,例如工具依附的 FIDL 服務、本機檔案系統項目、目標檔案系統路徑,或任何資訊清單/資訊清單格式。
請考慮指令與多部裝置的互動方式。
ffx提供全域--target,可明確宣告要與哪個裝置互動。指令是否需要存取設定或依附特定建構環境?如果是,請善用
ffx中的各種設定,或為特定指令或工作流程定義新設定。現有設定可透過ffx config get存取。
如需詳細指南和範例,請參閱「為 FFX 開發」。
CLI
指令列介面 (CLI) 提供 ffx 的 UX。負責事項包括:
- 剖析使用者參數 (CLI 參數)
- 將剖析的參數和要求的 FIDL 代理項目,轉送至適當的程式碼路徑以供執行
遙控器服務
遠端控制服務會在目標裝置上執行,負責提供目標裝置上執行的 FIDL 服務存取權。
FDomain
FDomain 是一種機制,可從開發主體機器與 Fuchsia 目標裝置上的 FIDL 服務通訊。這項通訊協定旨在取代 Overnet,詳情請參閱「FDomain 總覽」。