Android業務組件化之Gradle和Sonatype Nexus搭建私有maven倉庫

時間 2019-11-06

標籤 android 業務組件 gradle sonatype nexus 搭建私有 maven 倉庫欄目 Android 简体版

原文原文鏈接

前言：

公司的業務組件化推動的已經差很少三四個月的時間了，各個業務組件之間的解耦工做已經基本完成，各個業務組件以module的形式存在項目中，而後項目依賴本地的module，多少有點不太利於項目的並行開發維護了，本質緣由就是若是是依賴本地的，必需要將依賴的module和主工程放在一個project裏面，這就致使了每一個project都須要配置這些依賴關係，若是是公司內多個工程依賴同一個公司內部的業務組件，業務組件有更新時，同步很是麻煩，但公司內部的業務組件不可能部署到公有maven服務器上，因此有必要搭建一個局域網內的maven服務器，方便管理公司內部的公共庫及業務組件，經過查閱資料和技術預研肯定採用Gradle和Sonatype Nexus搭建私有maven倉庫的方式，今天總結一下如何搭建整套集成環境及簡單的使用。下圖簡單示例一下如今的項目結構：html

業務組件化相關博客：java

什麼是Maven？

Maven 是一個項目管理和自動構建工具。Maven 包集中存放的地方，就是 Maven 倉庫。這些倉庫，能夠是放在本地，也能夠放在某個遠程服務器上。能夠是私有倉庫，也能夠是公開的。在Android上的使用方式以下android

allprojects {
    repositories {
        mavenCentral();
        jcenter()
        maven {
            url 'file:///Users/my-user-name/Documents/Android/repo/'
        }
        maven {
            url 'http://localhost:8081/nexus/content/repositories/releases/'
        }
    }
}

什麼是Gradle？

Gradle是一個基於JVM的構建工具，是一款通用靈活的構建工具，支持maven， Ivy倉庫，支持傳遞性依賴管理，而不須要遠程倉庫或者是pom.xml和ivy.xml配置文件，基於Groovy，build腳本使用Groovy編寫。windows

Android支持的Maven倉庫：瀏覽器

mavenCentral 是最先的 maven 中央倉庫
jcenter 是 Android Studio 0.8 版本起的默認 maven 中央倉庫
本機的倉庫
部署在內網服務器的私有倉庫

使用Nexus搭建 maven 私服

1.下載Nexus

下載地址：http://www.sonatype.org/nexus/go服務器

2.啓動Nexus

我這裏下載的All platforms - Nexus Repository Manager OSS 2.x - bundle.zip，下載完成以後，解壓後進入\nexus-2.1.2-bundle\nexus-2.1.2\bin\jsw\，根據不一樣的系統選擇不一樣的文件夾進入，文件夾目錄結構以下：app

我這裏選擇的是windows-x86-64，大體裏面有這幾個操做項maven

console-nexus 啓動nexus並開啓控制檯
install-nexus 將nexus安裝成系統服務
start-nexus 開始nexus服務
stop-nexus 中止nexus服務
uninstall-nexus 卸載nexus系統服務

雙擊console-nexus.bat運行。再瀏覽器中輸入http://127.0.0.1:8081/nexus/，以下圖所示就表明nexus已經啓動成功了。工具

8081是默認的端口號，要修改端口號，進入\conf\打開nexus.properties文件，修改application-port屬性值就能夠了。默認的用戶名和密碼分別是：admin和admin123。組件化

3.Nexus倉庫

倉庫類型：

hosted(宿主倉庫):用來部署本身,第三方或者公共倉庫的構件
proxy(代理倉庫):代理遠程倉庫
virtual(虛擬倉庫):默認提供了一個 Central M1虛擬倉庫用來將maven 2適配爲maven 1
group(倉庫組):統一管理多個倉庫

Public Repositories: 倉庫組

3rd party: 沒法從公共倉庫得到的第三方發佈版本的構件倉庫
Apache Snapshots: 用了代理ApacheMaven倉庫快照版本的構件倉庫
Central: 用來代理maven中央倉庫中發佈版本構件的倉庫
Central M1 shadow: 用於提供中央倉庫中M1格式的發佈版本的構件鏡像倉庫
Codehaus Snapshots: 用來代理CodehausMaven 倉庫的快照版本構件的倉庫
Releases: 用來部署管理內部的發佈版本構件的宿主類型倉庫
Snapshots:用來部署管理內部的快照版本構件的宿主類型倉庫

4.建立宿主倉庫

新建公司的內部倉庫，步驟爲Repositories –> Add –> Hosted Repository，在頁面的下半部分輸入框中填入Repository ID和Repository Name便可，好比分別填入zfy 和 zfy repostiory，另外把Deployment Policy設置爲Allow Redeploy，點擊save就建立完成了。這裏我點擊添加宿主類型的倉庫，在倉庫列表的下方會出現新增倉庫的配置，以下所示：

點擊save按鈕後就會在倉庫列表中看到剛纔新增的倉庫。

Android 依賴包 AAR

1.什麼是AAR

AAR文件是Google爲Android開發所設計的一種library格式,全名爲Android Archive Library, 與Java Jar Library不一樣的地方是AAR除了java code以外也包含res,也就是一些圖片、文字等資源文件。會設計形式的類別庫是由於Google在Android SDK tool r14以後開始支持Library Project的開發方式,這種Library Project能夠說是Android APP的半成品,其目標並非製做成APK來執行,而是提供現成的View/Activiy等一些資源給其餘開發者使用。而 AAR正是這種Library Project編譯後的壓縮包,壓縮後只需傳遞單一文件便可分享,能夠說是至關方便。

2.Android項目打包成AAR

將一個Android項目打包成AAR你須要在項目的gradle腳本build.gradle文件中添加 apply plugin: ‘android-library’，而後編譯項目，在下圖示意的目錄下能夠找到打包好的arr文件

3.Android項目使用AAR

引用遠端的aar

compile 'com.squareup.okhttp3:okhttp:3.6.0'

引用本地aar文件

compile fileTree(dir: 'libs', include: '*.aar')

上傳庫到Maven倉庫

1.首先咱們建立一個新的AndroidStudio 項目，而後新建一個module，選擇Android Library，相似下面這種結構

Rebuild Project生成依賴的arr包

2.項目的根目錄的build.gradle中配置倉庫地址

allprojects {
    repositories {
        jcenter()
        maven{
            url 'http://localhost:8081/nexus/content/repositories/releases/'
        }
    }
}

3.配置gradle.properties文件，定義通用屬性

#Maven倉庫的URL
MAVEN_REPO_RELEASE_URL=http://localhost:8081/nexus/content/repositories/releases/
MAVEN_REPO_SNAPSHOT_URL=http://localhost:8081/nexus/content/repositories/snapshots/

#對應maven的GroupId的值
GROUP = com.xxx
#登陸nexus ossde的用戶名

NEXUS_USERNAME=admin
#登陸nexus oss的密碼

NEXUS_PASSWORD=admin123

# groupid
GROUP_ID = com.xxx

# type
TYPE = aar

# description
DESCRIPTION = app.lib

4.修改module對應的build.gradle文件，添加如下配置

uploadArchives {
    configuration = configurations.archives
    repositories {
        mavenDeployer {
            snapshotRepository(url: MAVEN_REPO_SNAPSHOT_URL) {
                authentication(userName: NEXUS_USERNAME, password: NEXUS_PASSWORD)
            }
            repository(url: MAVEN_REPO_RELEASE_URL) {
                authentication(userName: NEXUS_USERNAME, password: NEXUS_PASSWORD)
            }
            pom.project {
                version '1.0.0'
                artifactId 'app.lib'
                groupId GROUP_ID
                packaging TYPE
                description DESCRIPTION
            }
        }
    }
}

artifacts {
    archives file('app.lib.aar')
}

5.點擊uploadArchives進行編譯上傳

在as右邊欄，找到Gradle打開以下

而後雙擊uploadArchives，編譯腳本並上傳arr文件到私有倉庫，最後在控制檯能夠看到日誌是否上傳成功。

去倉庫查看到剛剛上傳的庫文件

在項目中應用

1.新建一個項目在項目的項目的根目錄build.gradle配置以下

maven{
      url 'http://localhost:8081/nexus/content/repositories/releases/'
    }

2.在app目錄下的build.gradle配置以下

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude group: 'com.android.support', module: 'support-annotations'
    })
    compile 'com.android.support:appcompat-v7:25.2.0'
    testCompile 'junit:junit:4.12'
    compile 'whoislcj:app.lib:1.0.0'
}

這樣配置就算結束了，就能夠正常的使用了。