以下是一些关于 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
时,请更新以下内容:
- 内核
cmdline
选项的列表/docs/reference/kernel/kernel_cmdline.md
。
备注
如何弃用 #define 常量
您可以创建已废弃的 typedef
并使用常量定义
转换为该类型。生成的警告或错误包含
已废弃的 typedef
的实现。
typedef int ZX_RESUME_NOT_HANDLED_DEPRECATION __attribute__((deprecated));
#define ZX_RESUME_NOT_HANDLED ((ZX_RESUME_NOT_HANDLED_DEPRECATION)(2))