以下是针对 Zircon 的补丁的一些一般准则。
流程
按照贡献更改中所述的 Fuchsia 补丁流程操作。
补丁通过 Gerrit Code Review 进行处理。
确保 Zircon 在每次更改时都可针对所有主要目标平台(
x86-64、arm64)进行构建。使用fx multi bringup-cq,以便 Zircon 可构建。 如需了解详情,请参阅为所有目标平台构建 Zircon。避免破坏单元测试。启动 Zircon 并运行测试,以验证它们是否全部通过。
避免出现空格或样式变化。尤其是,不要将样式更改与包含其他更改的补丁混在一起,因为样式更改往往会分散注意力。使用
fx format-code以一致的样式设置代码格式。如果可能,请避免同时触及多个模块的更改。大多数更改都应针对单个库、驱动程序、应用等。
Zircon 文档
编写文档是个好主意,我们鼓励您这样做:
- 文档应采用 Markdown 文件格式。
- Zircon 文档位于
/docs/concepts/kernel中。 - 在提交文档之前,请确保 Markdown 渲染正确。
在修改或添加 syscalls 或 cmdlines 时,请更新以下内容:
/docs/reference/kernel/kernel_cmdline.md中内核cmdline选项的列表。
备注
如何弃用 #define 常量
您可以创建一个已弃用的 typedef,并将常量定义强制转换为该类型。生成的警告或错误包含已弃用的 typedef 的名称。
typedef int ZX_RESUME_NOT_HANDLED_DEPRECATION __attribute__((deprecated));
#define ZX_RESUME_NOT_HANDLED ((ZX_RESUME_NOT_HANDLED_DEPRECATION)(2))