Yocto 项目与 OpenEmbedded 贡献者指南

Yocto 项目和 OpenEmbedded 都是由社区维护的开源项目。贡献让代码持续演进， 每个人都有机会推动改进，因此我们欢迎各种形式的贡献。 如果你修复了自己遇到的问题，提交补丁是最合适的方式。 如果发现问题但还没有解决方案，则可以在 Bugzilla 中报告缺陷， 或在邮件列表上提问。本指南帮助你找到适当的参与方式。

目录

• 1 确定所属组件
• 2 报告 Yocto 项目与 OpenEmbedded 的缺陷
• 3 配方风格指南
  • 3.1 配方命名约定
  • 3.2 版本规则
  • 3.3 版本号变更
  • 3.4 配方格式
    • 3.4.1 变量格式
    • 3.4.2 Python 函数格式
    • 3.4.3 Shell 函数格式
  • 3.5 配方元数据
    • 3.5.1 必需变量
    • 3.5.2 配方内容顺序
    • 3.5.3 配方许可证字段
      • 3.5.3.1 许可证更新
    • 3.5.4 编写配方的建议与准则
  • 3.6 补丁上游状态
    • 3.6.1 示例
  • 3.7 CVE 补丁
    • 3.7.1 CVE 示例
  • 3.8 补丁格式
• 4 向组件贡献修改
  • 4.1 通过邮件列表贡献：为什么不使用网页工作流？
  • 4.2 准备提交修改
    • 4.2.1 配置 Git
    • 4.2.2 克隆待修改组件的 Git 仓库
    • 4.2.3 创建新分支
    • 4.2.4 实现并提交修改
    • 4.2.5 测试修改
  • 4.3 生成补丁
  • 4.4 使用 Patchtest 验证补丁
  • 4.5 通过电子邮件发送补丁
    • 4.5.1 使用 Git 发送补丁
    • 4.5.2 配置 Git 发送邮件
    • 4.5.3 查找合适的邮件列表
    • 4.5.4 订阅邮件列表
    • 4.5.5 发送补丁邮件
    • 4.5.6 排查邮件问题
      • 4.5.6.1 修正 From 身份
    • 4.5.7 简化 git send-email 的使用
  • 4.6 使用脚本向上游推送修改并请求拉取
  • 4.7 向稳定发布分支提交修改
  • 4.8 根据补丁审阅意见修改
  • 4.9 跟踪补丁状态
  • 4.10 接受 AI 生成的代码

---

Yocto 项目中文文档

<docs@lists.yoctoproject.org>

允许按照 Creative Commons 发布的 知识共享署名—相同方式共享 2.0 英国：英格兰及威尔士许可 条款复制、分发和／或修改本文档。

如发现本手册或其他 Yocto 项目手册存在不准确之处或问题，或希望提交补充和修改， 请向 Yocto 项目文档邮件列表 docs@lists.yoctoproject.org 发送邮件或补丁， 也可以加入 Libera Chat 的 #yocto 频道。