Artifactory

一、概述

在实际业务开发中，可能会遇见很多通用模块管理问题，可能并不想每次打包的时候就去重新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( 下载链接 )，解压文件后，然后运行与平台对应的指令集即可。

解压后的 artifactory/bin 目录

由于服务器操作系统是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仓库 中文件目录如下：

maven 仓库 jcenter 目录

3.3 说明

当然，我们还可以设置更多自定义的缓存目录。

这里面支持设置包括 代理 、网络连接超时 等。更多功能，就等着更多的去发掘了。

四、说明

本文已经上传了示例项目 MavenRepository 到 Github 供参考。

本文对 自建 Maven仓库 - Artifactory 分析就到这了，错误之处烦请指正~

附：

Artifactory 官网