Dubbo 是在非限制性的 Apache 2.0 许可下发布的,遵循标准的 Github 开发流程,使用Github追踪处理问题,并将 pull request 合并到 master 中。如果您想为 Dubbo 做贡献(即便是一些微小的),请不要犹豫,遵循下面的指导方针。
邮件列表是讨论几乎所有与 Dubbo 有关事情的推荐方式。有关如何订阅的详细文档,请参阅指南。
在报告任何问题时请遵循模版。
我们的代码风格几乎和标准 Java 约定一致(流行IDE的默认设置满足这一点),主要有以下附加限制:
如果当前行中有超过 120 个字符,则起一个新的行。
确保所有新的 .java 文件都有一个简单的 JavaDoc 类注释,其中至少有一个标识创建日期的标签,最好至少有一个关于该类的解释说明。
将ASF许可注释添加到所有新的 .java 文件(从项目中的现有文件复制)
请确保没有将 @author 标记添加到您所贡献的文件中,因为 Apache 不使用 @author 标记,其他方式(如cvs)将公平地记录所有您的贡献。
为代码添加一些 JavaDoc,如果您更改命名空间,则需要一些 XSD DOC 元素。
对于新的特征或重要的修复程序,应该添加单元测试。
如果没有其他人使用您的分支,请将它与 master(或主项目中的其他目标分支)同步。
当编写提交消息时,请遵循这些约定,如果您正在修复一个现有问题,请在提交消息的末尾添加 Fixes XXX(其中XXX是问题编号)。
这是一个贡献者工作流程的大致说明:
git remote add upstream git@github.com:apache/dubbo.git
git fetch upstream
git rebase upstream/master
git checkout -b your_awesome_patch
... add some work
git push origin your_awesome_patch
谢谢您的贡献!
我们提供了 IntelliJ idea 的模版文件dubbo_codestyle_for_idea.xml,您可以将它导入到IDE。
如果使用 Eclipse,可以通过参考该文件手动配置。
注意事项
使用 dubbo_codestyle_for_idea.xml 为你的 IDEA 设置代码格式是贡献代码前至关重要的一个步骤,否则你将会无法通过 Travis CI 的代码风格校验,下面几个步骤给你演示了如何配置代码格式:
Editor > Code Style
Import Scheme
, 接着选择 IntelliJ IDEA code style XML
导入 xml 文件设置完成后,IDEA 会帮助你自动 reformat 代码