Maven本地仓库配置&二方库版本管理规范

617 阅读2分钟

持续创作,加速成长!这是我参与「掘金日新计划 · 6 月更文挑战」的第18天,点击查看活动详情

二方库版本管理规范

JAR版本说明

JAR包的版本由“<主版本>.<次版本>.<增量版本>” 组成,比如说1.2.3,主版本是1,次版本是2,增量版本是3。

主版本:用来表示功能、结构、架构上发生变化很大时的变更。

次版本:新功能开发,迭代等。

增量版本:用来修复次版本的bug或不足时使用。

JAR版本开发升级

例如:

<``groupId``>cn.securitystack</``groupId``>``<``artifactId``>ctu-email</``artifactId``>``<``version``>2.1</``version``>
  • 新功能迭代开发时:拉取二方库或公共模块feature分支,将开发版本新增为 2.2-SNAPSHOT ,等到开发测试完成后,最终合并master时,版本号变为2.2,并deploy代码仓库。
  • 线上有bug修复时:拉取新的hotfix分支,版本变为 2.1.1-SNAPSHOT,修复bug后,合并master时,版本号变为2.1.1,并deploy代码仓库。

本地Maven仓库配置


本地先备份$userhome/.m2/settings.xml文件(如果有的话),创建新的settings.xml文件,内容参考:setting.xml ,可修改配置指定本地仓库存储位置:

<localRepository>D:\dev\mvn-repo</localRepository>``或``<localRepository>/Users/zxkletters/.m2/repository</localRepository>

二方库的发布

二方库的发布需要在持续集成中完成,具体配置为:

maven-repo:``    ``stage: deploy``    ``image: harbor.dx-corp.top/basic/maven:``3.5``.``3``-jdk8``    ``only:``        ``- master``        ``- mix_master``    ``script:``        ``- fetch_settings_xml /root/.m2/settings.xml``        ``- mvn install -Dpmd.skip=``true -Dmaven.test.skip=``true``        ``- cp -f settings.xml /root/.m2/settings.xml``        ``- mvn deploy -Dpmd.skip=``true -Dmaven.test.skip=``true

以上配置的含义为:

  1.  需要在repo的主目录下放一个settings.xml文件,这个文件需要有mvn deploy的配置。当前这个文件可以在ctu-common项目中的mix_master分支中下载到。

  2. 在合入到master分支后就会将当前的二方库版本发布。

    1. TODO: 修改为打tag时即进行发布。
    2. TODO检查项: 当前准备发布的二方库版本需要和tag一致。