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 的使用者體驗。負責以下事項:
- 剖析使用者參數 (CLI 參數)
- 與 Daemon 通訊 (視需要啟動)
- 將剖析的參數和要求的 FIDL Proxy 轉送至適當的程式碼路徑來執行
Daemon
Daemon 會在主機裝置的背景中執行,並管理下列項目:
- 目標探索
- 目標生命週期管理 (更新、佈建和套件供應)
- 促進與目標裝置的通訊
遙控器服務
遠端控制服務會在目標裝置上執行,負責提供存取權給在目標上執行的 FIDL 服務。