Gradle for Android 第三篇( 依賴管理 )

依賴管理

依賴管理是Gradle最閃耀的地方，最好的情景是，你僅僅只需添加一行代碼在你的build文件，Gradle會自動從遠程倉庫為你下載相關的jar包，並且保證你能夠正確使用它們。Gradle甚至可以為你做的更多，包括當你在你的工程裡添加了多個相同的依賴，gradle會為你排除掉相同的jar包。在這一章我們將學習以下內容：

• 倉庫
• 本地依賴
• 詳解依賴這一概念

Gradle for Android 第一篇( 從 Gradle 和 AS 開始 )

Gradle for Android 第二篇( Build.gradle入門 )

Gradle for Android 第四篇( 構建變體 )

Gradle for Android 第五篇( 多模塊構建 )

倉庫

當我們討論依賴的時候，我們通常說的是遠程倉庫，就像那些依賴庫專門用來提供給其他開發者使用的依賴庫。手動管理依賴將會為你帶來很大麻煩。你必須定位到該依賴文件位置，然後下載jar文件，復制該文件到你的項目，然後引用它們。通常這些jar文件還沒有具體的版本號，所以你還必須去記憶它們的版本號，這樣當需要更新的時候，你才會知道需要替換成哪個版本。你同時必須將該依賴包放在svn或者git上，這樣你的其他同事才可以不用手動去下載這些依賴jar。

使用遠程倉庫可以解決這些問題，一個倉庫可以被視為一些文件的集合體。Gradle不會默認為你的項目添加任何倉庫。所以你需要把它們添加到repositories方法體內。如果是使用的是Android studio，那麼工具已經為你准備好了這一切：

repositories {
    jcenter()
}

Gradle支持三種不同的倉庫，分別是：Maven和Ivy以及文件夾。依賴包會在你執行build構建的時候從這些遠程倉庫下載，當然Gradle會為你在本地保留緩存，所以一個特定版本的依賴包只需要下載一次。

一個依賴需要定義三個元素：group，name和version。group意味著創建該library的組織名，通常這會是包名，name是該library的唯一標示。version是該library的版本號，我們來看看如何申明依賴：

dependencies {
       compile 'com.google.code.gson:gson:2.3'
       compile 'com.squareup.retrofit:retrofit:1.9.0'
}

上述的代碼是基於groovy語法的，所以其完整的表述應該是這樣的：

dependencies {
      compile group: 'com.google.code.gson', name: 'gson', version:'2.3'
      compile group: 'com.squareup.retrofit', name: 'retrofit'
           version: '1.9.0'
     }

為你的倉庫預定義

為了方便，Gradle會默認預定義三個maven倉庫：Jcenter和mavenCentral以及本地maven倉庫。你可以同時申明它們：

repositories {
       mavenCentral()
       jcenter()
       mavenLocal()
   }

Maven和Jcenter倉庫是很出名的兩大倉庫。我們沒必要同時使用他們，在這裡我建議你們使用jcenter，jcenter是maven中心庫的一個分支，這樣你可以任意去切換這兩個倉庫。當然jcenter也支持了https，而maven倉庫並沒有。

本地maven庫是你曾使用過的所有依賴包的集合，當然你也可以添加自己的依賴包。默認情況下，你可以在你的home文件下找到.m2的文件夾。除了這些倉庫外，你還可以使用其他的公有的甚至是私有倉庫。

遠程倉庫

有些組織，創建了一些有意思的插件或者library,他們更願意把這些放在自己的maven庫，而不是maven中心庫或jcenter。那麼當你需要是要這些倉庫的時候，你只需要在maven方法中加入url地址就好：

repositories {
       maven {
           url "http://repo.acmecorp.com/maven2"
       }
}

同樣的，Ivy倉庫也可以這麼做。Apache Ivy在ant世界裡是一個很出名的依賴管理工具。如果你的公司有自己的倉庫，如果他們需要權限才能訪問，你可以這麼編寫：

repositories {
       maven {
           url "http://repo.acmecorp.com/maven2"
           credentials {
               username 'user'
               password 'secretpassword'
           }
        } 
   }

注意：這不是一個好主意，最好的方式是把這些驗證放在Gradle properties文件裡，這些我們已經介紹過在第二章。

本地依賴

可能有些情況，你需要手動下載jar包，或者你想創建自己的library，這樣你就可以復用在不同的項目，而不必將該library publish到公有或者私有庫。在上述情況下，可能你不需要網絡資源，接下來我將介紹如何是使用這些jar依賴，以及如何導入so包，如何為你的項目添加依賴項目。

文件依賴

如果你想為你的工程添加jar文件作為依賴，你可以這樣：

dependencies {
       compile files('libs/domoarigato.jar')
}

如果你這麼做，那會很愚蠢，因為當你有很多這樣的jar包時，你可以改寫為：

dependencies {
       compile fileTree('libs')
 }

默認情況下，新建的Android項目會有一個lib文件夾，並且會在依賴中這麼定義（即添加所有在libs文件夾中的jar）：

dependencies {
       compile fileTree(dir: 'libs', include: ['*.jar'])
}

這也意味著，在任何一個Android項目中，你都可以把一個jar文件放在到libs文件夾下，其會自動的將其添加到編譯路徑以及最後的APK文件。

native包（so包）

用c或者c++寫的library會被叫做so包，Android插件默認情況下支持native包，你需要把.so文件放在對應的文件夾中：

app
   ├── AndroidManifest.xml
   └── jniLibs
       ├── armeabi
       │   └── nativelib.so
       ├── armeabi-v7a
       │   └── nativelib.so
       ├── mips
       │   └── nativelib.so
       └── x86
           └── nativelib.so

aar文件

如果你想分享一個library,該依賴包使用了Android api，或者包含了Android 資源文件，那麼aar文件適合你。依賴庫和應用工程是一樣的，你可以使用相同的tasks來構建和測試你的依賴工程，當然他們也可以有不同的構建版本。應用工程和依賴工程的區別在於輸出文件，應用工程會生成APK文件，並且其可以安裝在Android設備上，而依賴工程會生成.aar文件。該文件可以被Android應用工程當做依賴來使用。

創建和使用依賴工程模塊

不同的是，你需要加不同的插件：

 apply plugin: 'com.android.library'

我們有兩種方式去使用一個依賴工程。一個就是在你的工程裡面，直接將其作為一個模塊，另外一個就是創建一個aar文件，這樣其他的應用也就可以復用了。

如果你把其作為模塊，那你需要在settings.gradle文件中添加其為模塊：

   include ':app', ':library'

在這裡，我們就把它叫做library吧，如果你想使用該模塊，你需要在你的依賴裡面添加它，就像這樣:

   dependencies {
       compile project(':library')
  }

使用aar文件

如果你想復用你的library，那麼你就可以創建一個aar文件，並將其作為你的工程依賴。當你構建你的library項目，aar文件將會在 build/output/aar/下生成。把該文件作為你的依賴包，你需要創建一個文件夾來放置它，我們就叫它aars文件夾吧，然後把它拷貝到該文件夾裡面，然後添加該文件夾作為依賴庫：

repositories {
    flatDir {
        dirs 'aars' 
    }
}

這樣你就可以把該文件夾下的所有aar文件作為依賴，同時你可以這麼干：

 dependencies {
       compile(name:'libraryname', ext:'aar')
}

這個會告訴Gradle，在aars文件夾下，添加一個叫做libraryname的文件，且其後綴是aar的作為依賴。

依賴的概念

配置

有些時候，你可能需要和sdk協調工作。為了能順利編譯你的代碼，你需要添加SDK到你的編譯環境。你不需要將sdk包含在你的APK中，因為它早已經存在於設備中，所以配置來啦，我們會有5個不同的配置：

• compile
• apk
• provided
• testCompile
• androidTestCompile

compile是默認的那個，其含義是包含所有的依賴包，即在APK裡，compile的依賴會存在。

apk的意思是apk中存在，但是不會加入編譯中，這個貌似用的比較少。

provided的意思是提供編譯支持，但是不會寫入apk。

testCompile和androidTestCompile會添加額外的library支持針對測試。

這些配置將會被用在測試相關的tasks中，這會對添加測試框架例如JUnit或者Espresso非常有用，因為你只是想讓這些框架們能夠出現在測試apk中，而不是生產apk中。

除了這些特定的配置外，Android插件還為每個構建變體提供了配置，這讓debugCompile或者releaseProvided等配置成為可能。如果你想針對你的debug版本添加一個logging框架，這將很有用。這些內容的詳細介紹，我會在下一個博客裡詳細介紹。

動態版本

在一些情形中，你可能想使用最新的依賴包在構建你的app或者library的時候。實現他的最好方式是使用動態版本。我現在給你們展示幾種不同的動態控制版本方式：

dependencies {
       compile 'com.android.support:support-v4:22.2.+'
       compile 'com.android.support:appcompat-v7:22.2+'
       compile 'com.android.support:recyclerview-v7:+'
}

第一行，我們告訴gradle,得到最新的生產版本。第二行，我們告訴gradle，我們想得到最新的minor版本，並且其最小的版本號是2. 第三行，我們告訴gradle,得到最新的library。

你應該小心去使用動態版本，如果當你允許gradle去挑選最新版本，可能導致挑選的依賴版本並不是穩定版，這將會對構建產生很多問題，更糟糕的是你可能在你的服務器和私人pc上得到不同的依賴版本，這直接導致你的應用不同步。

如果你在你的build.gradle中使用了動態版本，Android studio將會警告你關於動態版本的潛在問題，就像你下面看到的這樣：

Android studio UI操作依賴庫

在使用Android studio中，最簡單的添加新依賴包的方法是使用工程結構彈框。從文件按鈕中打開界面，導航到依賴包導航欄，然後你就可以看到你當前的依賴包了：

當你想添加新的依賴包的時候，可以點擊綠色的小按鈕，你可以添加其他模塊，文件，甚至是上網搜索。

使用Android studio的界面讓你能夠很簡單的浏覽你項目中的所有依賴，並且添加新的依賴包。你不必在build.gradle中手動的添加代碼了，並且你可以直接搜索JCenter庫中的依賴資源。

總結

在這一章裡，我們了解了多種方式添加依賴，我們學習了什麼是倉庫，以及如何使用他們，同時學習了如何在不使用倉庫的情況下使用jar文件。

你現在知道了依賴包的屬性配置，動態版本控制等。

我們也談到了關於在多個環境下構建app變種，在下一章，我們將會學習到什麼是構建變種，以及為什麼他們很重要，構建變種將會使得開發測試以及分發app變得更加容易。理解變種的工作原理可以加快你的開發和分發效率。