本部分提供有关为 Fuchsia 创建 CLI 和 GUI 工具的指南。
如需了解现有工具,请参阅这些工具的文档。
其他主题
- 命令行工具要求
- 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)。