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 中的利益相关方。请参阅 Fuchsia API 委员会章程,找出 API 审核人员。

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

  • 向 API 委员会成员提交代码审核请求。 根据您要修改的 Fuchsia API 领域选择 API 委员会审核人。如需查看 API 委员会成员及其关注领域的列表,请参阅 Fuchsia API 委员会章程中的成员资格

将 API 提升为 partner_internal 类别

如果某个 API 被纳入 Fuchsia SDK 的 partner_internal SDK 类别中,则必须遵循 API 演变准则,该准则侧重于在保持兼容性的同时实现 API 演变。

请注意,向合作伙伴推广 API 时有一些额外的注意事项,这可能揭示在兼容性与长期可用性之间的权衡取舍。

API 可供审核后,请填写以下表单请求进行 API 校准:goto.google.com/fuchsia-api-calibration-request,指明此 API 的目标 API 是 partner_internal 类别。

如果您无法访问该表单,请向 api-council@fuchsia.dev 发送电子邮件,指明您要推广的一个或多个特定库,API 委员会将跟进后续步骤。

将 API 提升为 partner 类别

该 API 必须消除两个障碍,以便纳入 Fuchsia SDK 的 partnerpublic SDK 类别:必须有准备并且愿意的客户,并且该 API 必须已完成 API 校准

如需请求进行 API 校准,请填写以下表单:goto.google.com/fuchsia-api-calibration-request