贡献代码

官网英文原文地址:http://dev.px4.io/starting-contributing.html

核心开发团队和社区的联系信息可以在下面找到。PX4项目使用了三个分支Git branching model:

  • master 默认情况下不稳定,可以看到快速的开发。
  • beta 已充分测试,面向飞行测试者。
  • stable 指向最新的发布分支。

我们尝试通过rebases保持一个线性的历史,避免Github flow。但是由于全球的开发队伍和快速的开发转移,我们会定期分类合并。

为了贡献新的功能,首先注册Github账户,然后fork仓库,创建新分支,加入你的改变,最后发送pull request。当它们通过我们的持续的综合测试,更新就会被合并。

所有的贡献必须在 BSD 3-clause license许可下进行,并且所有的代码在使用上不能提出任何的,进一步的限制。

提交与提交消息

请使用描述性的、多段落提交消息进行所有非平凡的更改。 也可以好好组织语言,使其能够在一行的总结中有意义,并且依然提供全面的细节。

  1. Component: Explain the change in one sentence. Fixes #1234
  2. Prepend the software component to the start of the summary
  3. line, either by the module name or a description of it.
  4. (e.g. "mc_att_ctrl" or "multicopter attitude controller").
  5. If the issue number is appended as <Fixes #1234>, Github
  6. will automatically close the issue when the commit is
  7. merged to the master branch.
  8. The body of the message can contain several paragraphs.
  9. Describe in detail what you changed. Link issues and flight
  10. logs either related to this fix or to the testing results
  11. of this commit.
  12. Describe the change and why you changed it, avoid to
  13. paraphrase the code change (Good: "Adds an additional
  14. safety check for vehicles with low quality GPS reception".
  15. Bad: "Add gps_reception_check() function").
  16. Reported-by: Name <email@px4.io>

使用 git commit -s来结束你的所有提交。 这将会添加签名 signed-off-by: 以您的姓名和电子邮件作为最后一行。

此提交指南是基于Linux内核和Linus Torvalds维护的其他项目的最佳做法。

测试飞行结果

飞行测试对于保证质量非常重要,请从microSD卡上传飞行日志到 Log Muncher,并在PX4 Discuss分享链接,附带书面飞行报告。

论坛和聊天

每周开发电话

PX4开发团队每周都会进行电话会议,同步进度。