以下是关于 Zircon 补丁的一些通用准则。
处理
按照贡献更改中所述的 Fuchsia 补丁程序的流程操作。
补丁通过 Gerrit 代码审核进行处理。
确保在每次更改时,都可针对所有主要目标(
x86-64
、arm64
)构建 Zircon。使用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))