本部分包含有关为 Fuchsia API Surface 和 IDK 做贡献的文档。
从技术上讲,这种称为“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 的 partner
或 public
SDK 类别:必须有准备并且愿意的客户,并且该 API 必须已完成 API 校准。
如需请求进行 API 校准,请填写以下表单:goto.google.com/fuchsia-api-calibration-request。