Android項目中獨立Git庫源碼依賴技術方案

1、背景

文章 Android項目中獨立Git項目分庫後的編譯調試時Gradle的配置中介紹了Android項目中獨立Git庫源碼依賴時的本地處理方案。但在實際的項目開發中，因爲團隊多人協做以及可能存在的多獨立Git庫等狀況，實際上使用仍是有所不便。如採用Google Repo或者submodule方式，實際上也只是基於Git命令基礎上的腳本封裝，只是解決多庫的Git使用問題，而不能解決實際項目場景中的多獨立Git庫的統一AAR發佈、源碼依賴與AAR依賴的一鍵切換、甚至構建過程當中的定製與擴展等。

另外一方面，在源碼依賴領域，Gradle在幾年前就開始進行了嘗試，並在官網博文中發佈了文章: Introducing source dependencies,只是到目前爲止，在關鍵的authentication問題上尚未給出實質性的方案，還不能被正式使用。
具體參見： github.com/gradle/grad…

同時，對於獨立Git庫存在常常修改的狀況，這種方案也必須依賴於常常往遠程push commit方式。現實中，對於獨立Git庫的修改，能夠等主工程能夠直接有效果，基本穩定後，確認沒問題了再發布AAR，而後再一鍵切換到二進制AAR依賴。如此才能知足複雜項目場景中的現實須要。

固然，本文重點主要仍是圍繞源碼依賴進行，至關於現實項目場景總體方案其中的關鍵一個組成部分。

2、技術方案

文章 Android項目中獨立Git項目分庫後的編譯調試時Gradle的配置，其實已經提供了基本的源碼依賴思路，只是在具體實現上，沒有考慮到團隊多人協做以及可能存在的多獨立Git庫等狀況，手動逐個配置每每不便。如此，能夠在其基礎上進行一次升級，針對多獨立Git庫，經過Gralde Task和開關配置的方式，儘量的自動化其中的手動操做過程。

主要過程簡單示例以下，項目實際使用中能夠抽取成Gradle插件：
1，gradle.properties中配置源碼依賴開關：

sourceDependence = false
複製代碼

2, settings.gradle中include獨立Git庫本地源碼項目

if(sourceDependence.toBoolean()) {
    include ':components:uicomponent'
    project(':components:uicomponent').projectDir = new File(getRootDir().getParent() + '/components/uicomponent')
}
複製代碼

！！特別注意：雖然配置中寫的是true或false，但xx.gradle中獲取到此配置值實際上仍是對應的字符串，須要調用.toBoolean()強轉成對應的布爾類型，不然沒有效果。

3，項目根目錄build.gradle定義與獨立Git庫交互腳本，封裝成task：

buildscript {
    apply from: './buildConfig.gradle'

    repositories {
        google()
        jcenter()
        ....
    }
    dependencies {
        ....

        classpath 'org.ajoberstar.grgit:grgit-core:3.0.0'
        classpath 'org.ajoberstar.grgit:grgit-gradle:3.0.0'
    }
}


task sourceDependenceLib {
    doLast {
        doClone('components', 'git@git.xxx.com:xxx/android/xxx/components.git', 'dev')
    }
}

import org.ajoberstar.grgit.Grgit

void doClone(String dirName, String remote, String branch) {
    File dir = new File(getRootDir().getParent() + "/" + dirName)
    def git
    if(!dir.exists()) {
        git = Grgit.clone(dir: dir, uri: remote, refToCheckout: branch)
    }
    git = Grgit.open(dir: dir)
    git.checkout(branch: branch)
    git.pull(rebase: false)
}
複製代碼

4,主工程依賴中添加上源碼依賴切換邏輯：

ext {
	dependencies = [
    	....
    	uicomponent: "com.shopee.ui:uicomponent:$uicomponent_version"
    ]
}

if(sourceDependence.toBoolean()) {
    dependencies.uicomponent = project(':components:uicomponent')
}

複製代碼

執行sourceDependenceLib task，能夠直接git load下最新的指定分支源碼，打開sourceDependence開關，便可直接切換從二進制依賴切換到源碼依賴。

最終效果以下：

源碼依賴狀況下，能夠直接修改獨立Git庫代碼，直接源碼編譯。階段性穩定後發佈AAR。

end~