利用github搭建个人maven仓库的方法步骤
缘起
之前看到有开源项目用了github来做maven仓库,寻思自己也做一个。研究了下,记录下。
简单来说,共有三步:
- deploy到本地目录
- 把本地目录提交到gtihub上
- 配置github地址为仓库地址
配置local file maven仓库
deploy到本地
maven可以通过http, ftp, ssh等deploy到远程服务器,也可以deploy到本地文件系统里。
例如把项目deploy到/home/hengyunabc/code/maven-repo/repository/
目录下:
<distributionmanagement> <repository> <id>hengyunabc-mvn-repo</id> <url>file:/home/hengyunabc/code/maven-repo/repository/</url> </repository> </distributionmanagement>
通过命令行则是:
推荐使用命令行来deploy,避免在项目里显式配置。
把本地仓库提交到github上
上面把项目deploy到本地目录home/hengyunabc/code/maven-repo/repository里,下面把这个目录提交到github上。
在github上新建一个项目,然后把home/hengyunabc/code/maven-repo下的文件都提交到gtihub上。
cd /home/hengyunabc/code/maven-repo/ git init git add repository/* git commit -m 'deploy xxx' git remote add origin git@github.com:hengyunabc/maven-repo.git git push origin master
最终效果可以参考我的个人仓库:
github maven仓库的使用
因为github使用了raw.githubusercontent.com这个域名用于raw文件下载。所以使用这个maven仓库,只要在pom.xml里增加:
<repositories> <repository> <id>hengyunabc-maven-repo</id> <url>https://raw.githubusercontent.com/hengyunabc/maven-repo/master/repository</url> </repository> </repositories>
目录查看和搜索
值得注意的是,github因为安全原因,把raw文件下载和原来的github域名分开了,而raw.githubusercontent.com
这个域名是不支持目录浏览的。所以,想要浏览文件目录,或者搜索的话,可以直接到github域名下的仓库去查看。
比如这个文件mybatis-ehcache-spring-0.0.1-20150804.095005-1.jar:
浏览器地址是:
它的maven仓库url是:
maven仓库工作的机制
下面介绍一些maven仓库工作的原理。典型的一个maven依赖下会有这三个文件:
maven-metadata.xml maven-metadata.xml.md5 maven-metadata.xml.sha1
maven-metadata.xml
里面记录了最后deploy的版本和时间。
<?xml version="1.0" encoding="utf-8"?> <metadata modelversion="1.1.0"> <groupid>io.github.hengyunabc</groupid> <artifactid>mybatis-ehcache-spring</artifactid> <version>0.0.1-snapshot</version> <versioning> <snapshot> <timestamp>20150804.095005</timestamp> <buildnumber>1</buildnumber> </snapshot> <lastupdated>20150804095005</lastupdated> </versioning> </metadata>
其中md5, sha1校验文件是用来保证这个meta文件的完整性。
maven在编绎项目时,会先尝试请求maven-metadata.xml,如果没有找到,则会直接尝试请求到jar文件,在下载jar文件时也会尝试下载jar的md5, sha1文件。
maven-metadata.xml文件很重要,如果没有这个文件来指明最新的jar版本,那么即使远程仓库里的jar更新了版本,本地maven编绎时用上-u参数,也不会拉取到最新的jar!
所以并不能简单地把jar包放到github上就完事了,一定要先在本地deploy,生成maven-metadata.xml文件,并上传到github上。
参考:
maven的仓库关系
配置使用本地仓库
想要使用本地file仓库里,在项目的pom.xml里配置,如:
<repositories> <repository> <id>hengyunabc-maven-repo</id> <url>file:/home/hengyunabc/code/maven-repo/repository/</url> </repository> </repositories>
注意事项
maven的repository并没有优先级的配置,也不能单独为某些依赖配置repository。所以如果项目配置了多个repository,在首次编绎时,会依次尝试下载依赖。如果没有找到,尝试下一个,整个流程会很长。
所以尽量多个依赖放同一个仓库,不要每个项目都有一个自己的仓库。
参考
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
上一篇: android仿百度福袋红包界面