开发者手册

1.如何编译

安装 JDK7 及以上，Maven 3.2.5 及以上。
直接下载代码，然后在代码目录下执行如下命令：

  1. mvn clean install

2.版本发布

版本号

采用三位版本号，分别是主版本号、次版本号、修订版本号，例如 1.0.1。

参见: http://semver.org/lang/zh-CN/。

  • 主版本号：主版本号内的所有版本必须相互兼容；与其它主版本号不一定完全兼容，尽量向下兼容。
  • 次版本号：代表新特性增强。版本号越大特性越丰富。
  • 修订版本号：代表 BugFix 版本。只做 bug 修复使用，版本号越大越稳定。

版本维护

最多同时维护两个版本。

例如当前主干为 1.3.0，那么将会维护 1.2.x 的 bugfix 分支，而 1.1.x 遇到 bug 将不再修复，建议升级。

发布流程

  • 日常开发分支采用 SNAPSHOT 版本，例如 1.3.0-SNAPSHOT。
  • 正式发布时修改版本为正式版本，例如 1.3.0。
  • 发布后拉起下一个版本，例如 1.3.1-SNAPSHOT。

3.测试

单元测试

单元测试例子放到自己开发的模块下，测试类的包名与被测试类所在包相同。