最新要闻

广告

手机

光庭信息跌4.57% 2021上市超募11亿2022扣非降74% 时快讯

光庭信息跌4.57% 2021上市超募11亿2022扣非降74% 时快讯

搜狐汽车全球快讯 | 大众汽车最新专利曝光:仪表支持拆卸 可用手机、平板替代-环球关注

搜狐汽车全球快讯 | 大众汽车最新专利曝光:仪表支持拆卸 可用手机、平板替代-环球关注

家电

焦点热议:使用Gitee或GitHub托管Maven仓库JAR包的便捷方法

来源:博客园

原文地址:https://ntopic.cn/p/2023062201/

我开源的JAR包的Gitee和GitHub托管的Maven仓库:


(资料图片仅供参考)

  • Gitee托管仓库:https://gitee.com/obullxl/maven-repository
  • GitHub托管仓库:https://github.com/obullxl/maven-repository

背景说明

在上一篇博客中,我们介绍了开源通用高性能分布式id序列组件(https://ntopic.cn/p/2023062101/)的设计思路,并把源代码托管在了Gitee(https://gitee.com/obullxl/sequence-jdbc)和GitHub(https://github.com/obullxl/sequence-jdbc)。

我们希望能让更多人便捷的使用本组件,那么把JAR包放到到Maven官方的中心仓库(https://mvnrepository.com)当然是最好的选择。

然而要把JAR包上传到Maven官方中心仓库,步骤比较繁琐,包括注册、申请、发布配置等一系列操作。其实我们的本意只是想把自己的开源项目打包让大家方便使用,能否有更快捷的方式呢?当然是有的,我们可以使用Gitee或者GitHub作为Maven托管仓库,把我们的组件JAR包存储到托管仓库中。

Gitee/GitHub仓库设置

由于Gitee和GitHub原理完全一致,下面截图说明以Gitee为主(GitHub是我们的主仓库,Gitee只是同步GitHub仓库,但这不妨碍我们的配置)。

建议在Gitee中单独申请一个仓库,专门用于存放JAR包,比如我的仓库叫maven-repository:https://gitee.com/obullxl/maven-repository

同时,便于后续多个组件的JAR包能共用一个托管仓库,JAR包统一放到仓库的repository目录中:

特别注意:仓库请请设置为开源,否则其他人使用Maven托管仓库可能无法访问,从而无法下载组件JAR包:

打包发布JAR包到仓库

Gitee托管仓库设置好之后,开始设置我们打包并发布JAR包了。为便于后面设置打包命令,我们把托管Maven仓库的目录maven-repository和id序列组件仓库的目录sequence-jdbc放在同一个父目录中:

OXL-MacBook:CodeSpace obullxl$ lldrwxr-xr-x   7 obullxl  staff    224  6 24 10:30 maven-repositorydrwxr-xr-x  13 obullxl  staff    416  6 24 17:42 sequence-jdbc

组件pom.xml打包配置

完整的配置可直接参考分布式id序列的设置:https://gitee.com/obullxl/sequence-jdbc/blob/master/pom.xml

  • pom.xml文件,一定需要定义groupId/artifactId/version这Maven依赖坐标三要素:
cn.ntopicsequence-jdbc1.0.2jar
  • pom.xml文件,配置build节点,指定JAR打包、Deploy发布的配置(发布到Maven仓库的目录:../maven-repository/repository),即以下配置的altDeploymentRepository内容:
                        org.apache.maven.plugins            maven-compiler-plugin            2.3.2                            1.8                1.8                UTF-8                                        org.apache.maven.plugins            maven-jar-plugin            2.5                            org.apache.maven.plugins            maven-source-plugin            2.1.2                                                package                                            jar                                                                            org.codehaus.mojo            build-helper-maven-plugin            1.9.1                                                timestamp-property                                            timestamp-property                                                                            BuildTime                yyyy-MM-dd HH:mm:ss.SSS                GMT+8                                                                                        org.apache.maven.plugins            maven-antrun-plugin            1.3                                                generate-release                    compile                                            run                                                                                                                                                                                                                            org.apache.maven.plugins            maven-deploy-plugin            2.7                                            internal.repo::default::file://${project.basedir}/../maven-repository/repository                        

打包并上传到仓库

  • 打包并发布到本地目录命令:
mvn cleanmvn deploy -Dmaven.test.skip=true
  • 上传到远程仓库命令:
cd ./../maven-repositorygit add --allgit commit -m "Deploy sequence-jdbc JAR: https://github.com/obullxl/sequence-jdbc"git push origin master

完整的打包命令,请参考分布式id序列源仓库代码:https://gitee.com/obullxl/sequence-jdbc/blob/master/deploy.sh:

#!/bin/bash# 本地打包mvn clean && mvn deploy -Dmaven.test.skip=true# 上传仓库cd ./../maven-repositorygit add --allgit commit -m "Deploy sequence-jdbc JAR: https://github.com/obullxl/sequence-jdbc"git push origin master# 返回项目cd ../sequence-jdbc# Gitee刷新:人工刷新仓库,从GitHub同步过来open -a "/Applications/Microsoft Edge.app" https://gitee.com/obullxl/maven-repository

多个版本完整的Maven托管仓库内容:

其他项目使用JAR包方法

和Maven官方的中心仓库相比,Gitee托管仓库没有本质区别,只需要在pom.xml中配置Gitee的托管仓库即可,让Maven知道从哪儿去下载JAR包。

pom.xml中增加仓库

pom.xml中增加Gitee托管仓库地址:

      Gitee-obullxl    https://gitee.com/obullxl/maven-repository/raw/master/repository  

或者增加GitHub托管仓库地址:

         GitHub-obullxl      https://raw.githubusercontent.com/obullxl/maven-repository/master/repository   

Maven配置依赖

和其他JAR包一样,pom.xml中增加依赖坐标:

    cn.ntopic    sequence-jdbc    1.0.2

关键词: