一、概述
在实际业务开发中，可能会遇见很多通用模块管理问题，可能并不想每次打包的时候就去重新build对应模块，这会在一定程度上解放我们的开发效率；同样，由于墙的存在，有些时候打包总是一个遥遥无期的等待过程...
这种时候，要是有一个自由Maven仓库就好了！(当然，Github也欢迎你的轮子)
本文就介绍通过 Artifactory 傻瓜式快速搭建Maven仓库。
在简短的几个步骤后，就有了一个运行的Maven库。并且配置自己的jcenter镜像服务器，从此，再也不用每次苦苦等待打包去翻墙了呢~
二、配置、使用Maven仓库
2.1 Java 环境初始化
安装开始之前，确定本机电脑或者服务器已安装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 安装
从官网下载最新版本的 Artifactory( 下载链接 )，解压文件后，然后运行与平台对应的指令集即可。
由于服务器操作系统是Windows，我只需要双击运行 artifactory.bat 即可。
通过访问 http://localhost:8081/artifactory/ ，用默认管理员账号密码(用户名：admin，密码：password ) 登录，进入管理界面体验 Artifactory。
可能遇见的坑:
在运行
artifactory.bat的时候，确定系统已经配置JAVA_HOME环境变量，否则会报如下错误：
2.2.2 项目配置
在项目中添加 Gradle 任务，上传文件到 2.2.1节 中已经建好的 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'
上传的库由以下三个参数确定：
- groupId : 库的包名
- artifactId : 库的名称
- version : 版本号，用于区分不同版本
在本文的测试中，相关配置如下:
groupId = "com.burjal.testaar"
artifactId = "test"
version = "0.0.1"
注意： argifactId 需要和 assembleRelease 任务输出的文件名匹配。
2.2.2.3 添加maven-publish任务
将 assembleRelease 任务生成的 ***-release.aar 文件发布到 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 添加发布任务
配置 com.jfrog.artifactory 插件，指定发布到对应的库。本文提供的示例默认放到 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 发布
如下，通过 Gradle 任务，即可轻松发布到 Artifactory：
gradle assembleRelease generatePomFileForAarPublication artifactoryPublish
2.2.3 项目引用发布到 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 仓库信息列表，后续编译所需要的包都直接从私服 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()
}
}
这样，我们在后续的编译过程中，都会首先从私服 maven仓库 读取引用文件，当私服中不存在该文件时，第一次读取会缓存在服务器中。这样，就加快了编译获取引用包的网络请求。
3.2 示例
我们通过在项目中引用 okhttp (Github)作为示例。
在模块中添加 okhttp 引用：
compile "com.squareup.okhttp3:okhttp:$rootProject.okhttp"
首次编译完成后，我们可以看见 maven仓库 中文件目录如下：
3.3 说明
当然，我们还可以设置更多自定义的缓存目录。
这里面支持设置包括 代理 、网络连接超时 等。更多功能，就等着更多的去发掘了。
四、说明
本文已经上传了示例项目 MavenRepository 到 Github 供参考。
本文对 自建 Maven仓库 - Artifactory 分析就到这了，错误之处烦请指正~
附：
