一、概述
在實(shí)際業(yè)務(wù)開(kāi)發(fā)中，可能會(huì)遇見(jiàn)很多通用模塊管理問(wèn)題，可能并不想每次打包的時(shí)候就去重新build對(duì)應(yīng)模塊，這會(huì)在一定程度上解放我們的開(kāi)發(fā)效率；同樣，由于墻的存在，有些時(shí)候打包總是一個(gè)遙遙無(wú)期的等待過(guò)程...
這種時(shí)候，要是有一個(gè)自由Maven倉(cāng)庫(kù)就好了！(當(dāng)然，Github也歡迎你的輪子)
本文就介紹通過(guò) Artifactory 傻瓜式快速搭建Maven倉(cāng)庫(kù)。
在簡(jiǎn)短的幾個(gè)步驟后，就有了一個(gè)運(yùn)行的Maven庫(kù)。并且配置自己的jcenter鏡像服務(wù)器，從此，再也不用每次苦苦等待打包去翻墻了呢~
二、配置、使用Maven倉(cāng)庫(kù)
2.1 Java 環(huán)境初始化
安裝開(kāi)始之前，確定本機(jī)電腦或者服務(wù)器已安裝Java 8，否則 Artifactory 無(wú)法運(yùn)行。
C:\Users\Administrator>java -vsersion
java version "1.8.0_111"
Java(TM) SE Runtime Environment (build 1.8.0_111-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.111-b14, mixed mode)
如果輸出版本小于1.8.*，則需要先下載安裝最新的Java SDK( 下載鏈接 )。
2.2 安裝配置 Artifactory
2.2.1 安裝
從官網(wǎng)下載最新版本的 Artifactory( 下載鏈接 )，解壓文件后，然后運(yùn)行與平臺(tái)對(duì)應(yīng)的指令集即可。
由于服務(wù)器操作系統(tǒng)是Windows，我只需要雙擊運(yùn)行 artifactory.bat 即可。
通過(guò)訪問(wèn) http://localhost:8081/artifactory/ ，用默認(rèn)管理員賬號(hào)密碼(用戶名：admin，密碼：password ) 登錄，進(jìn)入管理界面體驗(yàn) Artifactory。
可能遇見(jiàn)的坑:
在運(yùn)行
artifactory.bat的時(shí)候，確定系統(tǒng)已經(jīng)配置JAVA_HOME環(huán)境變量，否則會(huì)報(bào)如下錯(cuò)誤：
2.2.2 項(xiàng)目配置
在項(xiàng)目中添加 Gradle 任務(wù)，上傳文件到 2.2.1節(jié) 中已經(jīng)建好的 maven倉(cāng)庫(kù) 中。
2.2.2.1 添加引用
在項(xiàng)目根目錄的 build.gradle 中，添加 Artifactory Gradle 插件的引用：
buildscript {
dependencies {
...
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
classpath "org.jfrog.buildinfo:build-info-extractor-gradle:4.4.13"
}
}
2.2.2.2 引用插件
然后在需要上傳到 maven 倉(cāng)庫(kù)的模塊中，添加上傳需要的插件：
apply plugin: 'maven-publish'
apply plugin: 'com.jfrog.artifactory'
上傳的庫(kù)由以下三個(gè)參數(shù)確定：
- groupId : 庫(kù)的包名
- artifactId : 庫(kù)的名稱
- version : 版本號(hào)，用于區(qū)分不同版本
在本文的測(cè)試中，相關(guān)配置如下:
groupId = "com.burjal.testaar"
artifactId = "test"
version = "0.0.1"
注意： argifactId 需要和 assembleRelease 任務(wù)輸出的文件名匹配。
2.2.2.3 添加maven-publish任務(wù)
將 assembleRelease 任務(wù)生成的 ***-release.aar 文件發(fā)布到 Artifactory。
publishing {
publications {
aar(MavenPublication) {
groupId = "com.burjal.testaar"
artifactId = "test"
version = "0.0.1"
// Tell maven to prepare the generated "* .aar" file for publishing
artifact("$buildDir/outputs/aar/${project.getName()}-release.aar")
}
}
}
2.2.2.4 添加發(fā)布任務(wù)
配置 com.jfrog.artifactory 插件，指定發(fā)布到對(duì)應(yīng)的庫(kù)。本文提供的示例默認(rèn)放到 libs-release-local 庫(kù)中。
artifactory {
contextUrl = 'http://zixigou.com:8081/artifactory'
publish {
repository {
// The Artifactory repository key to publish to
repoKey = 'libs-release-local'
def loginInfo = getArtifactoryLoginInfo() //安全性考慮，從配置文件中讀取用戶登錄信息
username = loginInfo[0]
password = loginInfo[1]
}
defaults {
// Tell the Artifactory Plugin which artifacts should be published to Artifactory.
publications('aar')
publishArtifacts = true
// Properties to be attached to the published artifacts.
properties = ['qa.level': 'basic', 'dev.team': 'core']
// Publish generated POM files to Artifactory (true by default)
publishPom = true
}
}
}
2.2.2.5 發(fā)布
如下，通過(guò) Gradle 任務(wù)，即可輕松發(fā)布到 Artifactory：
gradle assembleRelease generatePomFileForAarPublication artifactoryPublish
2.2.3 項(xiàng)目引用發(fā)布到 Artifactory 的模塊
在需要使用到該 artifact ，在項(xiàng)目根目錄的 build.gradle 文件中，把私有 maven倉(cāng)庫(kù) 信息添加到倉(cāng)庫(kù)列表中。
buildscript {
repositories {
maven {
url "http://zixigou.com:8081/artifactory/libs-release-local"
}
jcenter()
}
dependencies {
...
}
}
allprojects {
repositories {
maven {
url "http://zixigou.com:8081/artifactory/libs-release-local"
}
jcenter()
}
}
然后在項(xiàng)目對(duì)應(yīng)使用到該模塊的 build.gradle 文件中添加 artifact 作為依賴就可以了：
compile "com.burjal.testaar:test:$rootProject.test_aar"
三、使用jcenter緩存
3.1 配置
Artifactory 默認(rèn)將 jecnter 庫(kù)緩存到私有 maven倉(cāng)庫(kù) 中。
因此，我們可以在項(xiàng)目中配置 jcenter 倉(cāng)庫(kù)信息列表，后續(xù)編譯所需要的包都直接從私服 maven倉(cāng)庫(kù) 讀取，加快項(xiàng)目編譯速度。
我們通過(guò)添加 okhttp 引用示例 (Github)。
在項(xiàng)目根目錄的 build.gradle 文件中，把私有 maven倉(cāng)庫(kù) 信息添加到倉(cāng)庫(kù)列表中:
buildscript {
repositories {
maven {
url "http://zixigou.com:8081/artifactory/jcenter" // 配置私服jcenter倉(cāng)庫(kù)信息
}
maven {
url "http://zixigou.com:8081/artifactory/libs-release-local"
}
jcenter()
}
dependencies {
...
}
}
allprojects {
repositories {
maven {
url "http://zixigou.com:8081/artifactory/jcenter" // 配置私服jcenter倉(cāng)庫(kù)信息
}
maven {
url "http://zixigou.com:8081/artifactory/libs-release-local"
}
jcenter()
}
}
這樣，我們?cè)诤罄m(xù)的編譯過(guò)程中，都會(huì)首先從私服 maven倉(cāng)庫(kù) 讀取引用文件，當(dāng)私服中不存在該文件時(shí)，第一次讀取會(huì)緩存在服務(wù)器中。這樣，就加快了編譯獲取引用包的網(wǎng)絡(luò)請(qǐng)求。
3.2 示例
我們通過(guò)在項(xiàng)目中引用 okhttp (Github)作為示例。
在模塊中添加 okhttp 引用：
compile "com.squareup.okhttp3:okhttp:$rootProject.okhttp"
首次編譯完成后，我們可以看見(jiàn) maven倉(cāng)庫(kù) 中文件目錄如下：
3.3 說(shuō)明
當(dāng)然，我們還可以設(shè)置更多自定義的緩存目錄。
這里面支持設(shè)置包括 代理 、網(wǎng)絡(luò)連接超時(shí) 等。更多功能，就等著更多的去發(fā)掘了。
四、說(shuō)明
本文已經(jīng)上傳了示例項(xiàng)目 MavenRepository 到 Github 供參考。
本文對(duì) 自建 Maven倉(cāng)庫(kù) - Artifactory 分析就到這了，錯(cuò)誤之處煩請(qǐng)指正~
附：
