Zircon 贡献者指南

以下是针对 Zircon 的补丁的一些一般准则。

流程

  • 按照贡献更改中所述的 Fuchsia 补丁流程操作。

  • 补丁通过 Gerrit Code Review 进行处理。

  • 确保 Zircon 在每次更改时都可针对所有主要目标平台(x86-64arm64)进行构建。使用 fx multi bringup-cq,以便 Zircon 可构建。 如需了解详情,请参阅为所有目标平台构建 Zircon

  • 避免破坏单元测试。启动 Zircon 并运行测试,以验证它们是否全部通过。

  • 避免出现空格或样式变化。尤其是,不要将样式更改与包含其他更改的补丁混在一起,因为样式更改往往会分散注意力。使用 fx format-code 以一致的样式设置代码格式。

  • 如果可能,请避免同时触及多个模块的更改。大多数更改都应针对单个库、驱动程序、应用等。

Zircon 文档

编写文档是个好主意,我们鼓励您这样做:

  • 文档应采用 Markdown 文件格式。
  • Zircon 文档位于 /docs/concepts/kernel 中。
  • 在提交文档之前,请确保 Markdown 渲染正确。

在修改或添加 syscallscmdlines 时,请更新以下内容:

备注

如何弃用 #define 常量

您可以创建一个已弃用的 typedef,并将常量定义强制转换为该类型。生成的警告或错误包含已弃用的 typedef 的名称。

typedef int ZX_RESUME_NOT_HANDLED_DEPRECATION __attribute__((deprecated));
#define ZX_RESUME_NOT_HANDLED ((ZX_RESUME_NOT_HANDLED_DEPRECATION)(2))