
一、概述
在實際業(yè)務開發(fā)中,可能會遇見很多通用模塊管理問題,可能并不想每次打包的時候就去重新build對應模塊,這會在一定程度上解放我們的開發(fā)效率;同樣,由于墻的存在,有些時候打包總是一個遙遙無期的等待過程...
這種時候,要是有一個自由Maven倉庫就好了!(當然,Github也歡迎你的輪子)
本文就介紹通過 Artifactory 傻瓜式快速搭建Maven倉庫。
在簡短的幾個步驟后,就有了一個運行的Maven庫。并且配置自己的jcenter鏡像服務器,從此,再也不用每次苦苦等待打包去翻墻了呢~
二、配置、使用Maven倉庫
2.1 Java 環(huán)境初始化
安裝開始之前,確定本機電腦或者服務器已安裝Java 8,否則 Artifactory 無法運行。
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( 下載鏈接 ),解壓文件后,然后運行與平臺對應的指令集即可。

由于服務器操作系統(tǒng)是Windows,我只需要雙擊運行 artifactory.bat 即可。
通過訪問 http://localhost:8081/artifactory/ ,用默認管理員賬號密碼(用戶名:admin,密碼:password ) 登錄,進入管理界面體驗 Artifactory。
可能遇見的坑:
在運行
artifactory.bat的時候,確定系統(tǒng)已經(jīng)配置JAVA_HOME環(huán)境變量,否則會報如下錯誤:
2.2.2 項目配置
在項目中添加 Gradle 任務,上傳文件到 2.2.1節(jié) 中已經(jīng)建好的 maven倉庫 中。
2.2.2.1 添加引用
在項目根目錄的 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 倉庫的模塊中,添加上傳需要的插件:
apply plugin: 'maven-publish'
apply plugin: 'com.jfrog.artifactory'
上傳的庫由以下三個參數(shù)確定:
- groupId : 庫的包名
- artifactId : 庫的名稱
- version : 版本號,用于區(qū)分不同版本
在本文的測試中,相關配置如下:
groupId = "com.burjal.testaar"
artifactId = "test"
version = "0.0.1"
注意: argifactId 需要和 assembleRelease 任務輸出的文件名匹配。
2.2.2.3 添加maven-publish任務
將 assembleRelease 任務生成的 ***-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ā)布任務
配置 com.jfrog.artifactory 插件,指定發(fā)布到對應的庫。本文提供的示例默認放到 libs-release-local 庫中。
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ā)布
如下,通過 Gradle 任務,即可輕松發(fā)布到 Artifactory:
gradle assembleRelease generatePomFileForAarPublication artifactoryPublish
2.2.3 項目引用發(fā)布到 Artifactory 的模塊
在需要使用到該 artifact ,在項目根目錄的 build.gradle 文件中,把私有 maven倉庫 信息添加到倉庫列表中。
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()
}
}
然后在項目對應使用到該模塊的 build.gradle 文件中添加 artifact 作為依賴就可以了:
compile "com.burjal.testaar:test:$rootProject.test_aar"
三、使用jcenter緩存
3.1 配置
Artifactory 默認將 jecnter 庫緩存到私有 maven倉庫 中。
因此,我們可以在項目中配置 jcenter 倉庫信息列表,后續(xù)編譯所需要的包都直接從私服 maven倉庫 讀取,加快項目編譯速度。
我們通過添加 okhttp 引用示例 (Github)。
在項目根目錄的 build.gradle 文件中,把私有 maven倉庫 信息添加到倉庫列表中:
buildscript {
repositories {
maven {
url "http://zixigou.com:8081/artifactory/jcenter" // 配置私服jcenter倉庫信息
}
maven {
url "http://zixigou.com:8081/artifactory/libs-release-local"
}
jcenter()
}
dependencies {
...
}
}
allprojects {
repositories {
maven {
url "http://zixigou.com:8081/artifactory/jcenter" // 配置私服jcenter倉庫信息
}
maven {
url "http://zixigou.com:8081/artifactory/libs-release-local"
}
jcenter()
}
}
這樣,我們在后續(xù)的編譯過程中,都會首先從私服 maven倉庫 讀取引用文件,當私服中不存在該文件時,第一次讀取會緩存在服務器中。這樣,就加快了編譯獲取引用包的網(wǎng)絡請求。
3.2 示例
我們通過在項目中引用 okhttp (Github)作為示例。
在模塊中添加 okhttp 引用:
compile "com.squareup.okhttp3:okhttp:$rootProject.okhttp"
首次編譯完成后,我們可以看見 maven倉庫 中文件目錄如下:

3.3 說明
當然,我們還可以設置更多自定義的緩存目錄。

這里面支持設置包括 代理 、網(wǎng)絡連接超時 等。更多功能,就等著更多的去發(fā)掘了。
四、說明
本文已經(jīng)上傳了示例項目 MavenRepository 到 Github 供參考。
本文對 自建 Maven倉庫 - Artifactory 分析就到這了,錯誤之處煩請指正~
附:
