自建Maven倉庫 - Artifactory

Burjal本尊發表於2017-12-19
Maven

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 環境變數，否則會報如下錯誤：

自建Maven倉庫 - Artifactory

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 說明

當然，我們還可以設定更多自定義的快取目錄。

自建Maven倉庫 - Artifactory

這裡面支援設定包括 代理 、網路連線超時 等。更多功能，就等著更多的去發掘了。

四、說明

本文已經上傳了示例專案 MavenRepository 到 Github 供參考。

本文對 自建 Maven倉庫 - Artifactory 分析就到這了，錯誤之處煩請指正~

附：

Artifactory 官網

相關文章