Fuchsia SDK 贡献者指南

本部分包含有关贡献 Fuchsia API SurfaceIDK 的文档。

从技术层面来看,更恰当的做法是将其称为“IDK 贡献者指南”,因为构成 API Surface 的 API 和库会先添加到 IDK,然后 IDK 会转换为 SDK 分发。不过,在口语和代码中,我们几乎只会说“SDK”。无论如何,如果您想以某种方式“更改 SDK”,那么您可能来对地方了。

为 SDK 中的 API 贡献代码

如需为 Fuchsia API Surface 做出贡献,请执行以下操作:

  • 评估更改的大小。

    • 如果您对 API 进行了细微的增量更改,请按照在 Gerrit 中创建更改中的步骤贡献您的更改,就像对任何 Fuchsia 源代码更改一样。
    • 如果您对 API 进行了重大更改(即,更改会显著扩展 API 的功能或对 API 进行大幅修改),请执行以下操作:

    • 创建 RFC,说明您对 API 所做的修改的设计。

    • 此 RFC 应通过正常的 RFC 流程进行审核。相关领域的 API 审核员应是 RFC 的利益相关方。如需确定 API 审核员,请参阅 Fuchsia API 委员会章程

    • 您的 API RFC 获得批准后,请按照在 Gerrit 中创建更改中的步骤贡献您的更改,就像贡献任何 Fuchsia 源代码更改一样。

  • 向 API 委员会成员申请代码审核。根据您要修改的 Fuchsia API 领域选择 API 委员会审核员。如需查看 API 委员会成员及其重点领域的列表,请参阅 Fuchsia API 委员会章程中的成员资格部分。

将 API 提升到 prebuilthost_tool 类别

为了让 API 可供 Fuchsia SDK 中的预构建二进制文件或宿主工具使用,该 API 必须分别位于 prebuilthost_tool SDK 类别中。该 API 必须遵循 API 演变准则,该准则侧重于在保持兼容性的同时实现 API 演变。

请注意,将 API 提升到 partner 时还需要考虑其他因素,这可能会揭示在兼容性和长期易用性之间做出的权衡决策。

当 API 准备好接受审核后,请填写此表单:goto.google.com/fuchsia-api-calibration-request,指明此 API 定位到新类别,以请求 API 校准。

如果您无权使用该表单,请发送电子邮件至 api-council@fuchsia.dev,指明您要宣传的特定库,API 委员会会随后跟进后续步骤。

将 API 提升到 partner 类别

要将某个 API 纳入 Fuchsia SDK 的 partnerpublic SDK 类别,该 API 必须跨越两个障碍:必须有准备就绪且愿意使用的客户,并且该 API 必须已通过 API 校准

如需申请 API 校准,请填写此表单:goto.google.com/fuchsia-api-calibration-request