緣起

之前看到有開(kāi)源項(xiàng)目用了github來(lái)做maven倉(cāng)庫(kù)，尋思自己也做一個(gè)。研究了下，記錄下。

簡(jiǎn)單來(lái)說(shuō)，共有三步：

• deploy到本地目錄
• 把本地目錄提交到gtihub上
• 配置github地址為倉(cāng)庫(kù)地址

配置local file maven倉(cāng)庫(kù)

deploy到本地

maven可以通過(guò)http, ftp, ssh等deploy到遠(yuǎn)程服務(wù)器，也可以deploy到本地文件系統(tǒng)里。

例如把項(xiàng)目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>

通過(guò)命令行則是：

推薦使用命令行來(lái)deploy，避免在項(xiàng)目里顯式配置。

https://maven.apache.org/plugins/maven-deploy-plugin/

https://maven.apache.org/plugins/maven-deploy-plugin/deploy-file-mojo.html

把本地倉(cāng)庫(kù)提交到github上

上面把項(xiàng)目deploy到本地目錄home/hengyunabc/code/maven-repo/repository里，下面把這個(gè)目錄提交到github上。

在Github上新建一個(gè)項(xiàng)目，然后把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

最終效果可以參考我的個(gè)人倉(cāng)庫(kù)：

https://github.com/hengyunabc/maven-repo

github maven倉(cāng)庫(kù)的使用

因?yàn)間ithub使用了raw.githubusercontent.com這個(gè)域名用于raw文件下載。所以使用這個(gè)maven倉(cāng)庫(kù)，只要在pom.xml里增加：

 <repositories>
  <repository>
   <id>hengyunabc-maven-repo</id>
   <url>https://raw.githubusercontent.com/hengyunabc/maven-repo/master/repository</url>
  </repository>
 </repositories>

目錄查看和搜索

值得注意的是，github因?yàn)榘踩?，把raw文件下載和原來(lái)的github域名分開(kāi)了，而raw.githubusercontent.com這個(gè)域名是不支持目錄瀏覽的。所以，想要瀏覽文件目錄，或者搜索的話，可以直接到github域名下的倉(cāng)庫(kù)去查看。

比如這個(gè)文件mybatis-ehcache-spring-0.0.1-20150804.095005-1.jar：

瀏覽器地址是：

https://github.com/hengyunabc/maven-repo/blob/master/repository/io/github/hengyunabc/mybatis-ehcache-spring/0.0.1-SNAPSHOT/mybatis-ehcache-spring-0.0.1-20150804.095005-1.jar

它的maven倉(cāng)庫(kù)url是：

https://raw.githubusercontent.com/hengyunabc/maven-repo/master/repository/io/github/hengyunabc/mybatis-ehcache-spring/0.0.1-SNAPSHOT/mybatis-ehcache-spring-0.0.1-20150804.095005-1.jar

maven倉(cāng)庫(kù)工作的機(jī)制

下面介紹一些maven倉(cāng)庫(kù)工作的原理。典型的一個(gè)maven依賴下會(huì)有這三個(gè)文件：

https://github.com/hengyunabc/maven-repo/tree/master/repository/io/github/hengyunabc/mybatis-ehcache-spring/0.0.1-SNAPSHOT

maven-metadata.xml
maven-metadata.xml.md5
maven-metadata.xml.sha1

maven-metadata.xml里面記錄了最后deploy的版本和時(shí)間。

<?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校驗(yàn)文件是用來(lái)保證這個(gè)meta文件的完整性。

maven在編繹項(xiàng)目時(shí)，會(huì)先嘗試請(qǐng)求maven-metadata.xml，如果沒(méi)有找到，則會(huì)直接嘗試請(qǐng)求到j(luò)ar文件，在下載jar文件時(shí)也會(huì)嘗試下載jar的md5, sha1文件。

maven-metadata.xml文件很重要，如果沒(méi)有這個(gè)文件來(lái)指明最新的jar版本，那么即使遠(yuǎn)程倉(cāng)庫(kù)里的jar更新了版本，本地maven編繹時(shí)用上-U參數(shù)，也不會(huì)拉取到最新的jar！

所以并不能簡(jiǎn)單地把jar包放到github上就完事了，一定要先在本地Deploy，生成maven-metadata.xml文件，并上傳到github上。

參考：http://maven.apache.org/ref/3.2.2/maven-repository-metadata/repository-metadata.html

maven的倉(cāng)庫(kù)關(guān)系

https://maven.apache.org/repository/index.html

配置使用本地倉(cāng)庫(kù)

想要使用本地file倉(cāng)庫(kù)里，在項(xiàng)目的pom.xml里配置，如：

 <repositories>
  <repository>
   <id>hengyunabc-maven-repo</id>
   <url>file:/home/hengyunabc/code/maven-repo/repository/</url>
  </repository>
 </repositories>

注意事項(xiàng)

maven的repository并沒(méi)有優(yōu)先級(jí)的配置，也不能單獨(dú)為某些依賴配置repository。所以如果項(xiàng)目配置了多個(gè)repository，在首次編繹時(shí)，會(huì)依次嘗試下載依賴。如果沒(méi)有找到，嘗試下一個(gè)，整個(gè)流程會(huì)很長(zhǎng)。

所以盡量多個(gè)依賴放同一個(gè)倉(cāng)庫(kù)，不要每個(gè)項(xiàng)目都有一個(gè)自己的倉(cāng)庫(kù)。

參考
http://stackoverflow.com/questions/14013644/hosting-a-maven-repository-on-github/14013645#14013645
http://cemerick.com/2010/08/24/hosting-maven-repos-on-github/

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論