为 Zircon 做出贡献

以下是关于 Zircon 补丁的一些通用准则。

处理

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

  • 补丁通过 Gerrit 代码审核进行处理。

  • 确保在每次更改时,都可针对所有主要目标(x86-64arm64)构建 Zircon。使用 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))