開發人員工具指南

本節提供在「Fuchsia」建立 CLI 和 GUI 工具的指南。

如要瞭解現有工具，請參閱這些工具的說明文件。

其他主題

包裝要納入整合商開發套件 (IDK) 的工具

整合商開發套件 (IDK) 的內容包含：

  • 工具二進位檔本身。

  • //docs/development/idk/documentation 文件詳細說明這項工具的合約規定，以及如何將這項工具連結至目標系統。本文件的目標對像是撰寫整合指令碼的人，而非容易使用的「操作說明」(偵錯工具範例)。

特定環境的 SDK

ffx target list 指令會提取所有 SDK 變化版本的裝置清單和選項。採用合適的工具設計時，所需的整合程度應執行 ffx target list 來取得位址，並將該位址傳遞至工具，並搭配其他環境專屬標記。在偵錯工具的情況下，工具專屬的程式碼會如下所示：

  • 連線至目標的殼層 (必須是特定環境 SDK 提供的基本程式)，然後執行 debug_agent。

  • 使用 ffx target list 提供的位址執行 zxdb，並在指令列上傳遞任何本機設定檔和符號路徑。

工具需求

工具應允許所有環境參數透過指令列引數傳入。例如設定檔的位置和符號位置。如此一來，不同 SDK 就能變得密封無比。

您應編寫工具，盡可能簡化特定環境的指令碼編寫作業。舉例來說，偵錯工具應自動重試連線 (https://fxbug.dev/42137364)，以便移除目前等待通訊埠在啟動指令碼中開啟的目前行為。

工具作者負責：

  • 使用適當的介面編寫工具。
  • 如要提供這個介面的說明文件，請前往 //docs/Development/idk/documentation。
  • 目前請聯繫開發人員，取得個別 SDK 回報錯誤。我們正在開發更好的程序 (https://fxbug.dev/42137108)。