ffx 工具

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 服務。