开发者工具指南

本部分提供有关为 Fuchsia 创建 CLI 和 GUI 工具的指南。

如需了解现有工具,请参阅这些工具的文档。

其他主题

将工具打包到集成器开发套件 (IDK) 中

集成商开发套件 (IDK) 将包含:

  • 工具二进制文件本身。

  • //docs/development/idk/documentation 中的文档,其中介绍了此工具的合约以及如何将其连接到目标系统。本文档的目标受众群体是编写集成脚本的人员,而不是最终用户友好的“操作指南”(调试程序示例)。

针对特定环境的 SDK

ffx target list 命令会抽象化所有 SDK 变体中的设备列表和选择。采用正确的工具设计后,所需的集成程度应该是运行 ffx target list 来获取地址,并使用其他特定于环境的标志将地址传递给工具。在调试程序的情况下,工具专用代码将:

  • 连接到目标上的 shell(这应该是特定于环境的 SDK 提供的基元)并运行 debug_agent

  • 使用 ffx target list 提供的地址运行 zxdb,在命令行中传递所有本地设置文件和符号路径。

工具要求

工具应允许通过命令行参数传入所有环境参数。例如设置文件的位置和符号位置。这样一来,不同的 SDK 便可以是封闭的。

工具的编写应尽可能简单地编写特定于环境的脚本。例如,调试程序应自动重试连接 (https://fxbug.dev/42137364),以便移除在启动脚本中等待端口打开的当前行为。

工具作者负责:

  • 使用适当的接口编写工具。
  • 在 //docs/develop/idk/documentation 中提供关于此接口的文档。
  • 目前,如需获取针对各个 SDK 提交的 bug,请联系我们。我们正在努力解决此问题 (https://fxbug.dev/42137108)。