自建Maven仓库 - Artifactory

2,332 阅读3分钟
原文链接: www.jianshu.com

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 官网