最近趕專案，白天基本沒時間，只有晚上在家的時候才能看一看。昨天晚上只翻譯完了第四章，今天就只發第四章吧。

本文譯自Android官方技術文件《Gradle Plugin User Guide》,原文地址：http://tools.android.com/tech-docs/new-build-system/user-guide。

翻譯不易，轉載請註明CSDN部落格上的出處：

http://blog.csdn.net/maosidiaoxian/article/details/41955809

翻譯工作耗時費神，如果你覺得本文翻譯得還OK，請點一下“頂”，我在精神上會倍受鼓勵的，謝謝。翻譯如有錯訛，敬請指正。

依賴、 Android Library和多專案設定

Gradle 專案可以對其他元件具有依賴關係。這些元件可以是外部的二進位制包，或其他的 Gradle 專案。

二進位制包的依賴

本地包

要配置一個外部庫 jar 包的依賴，您需要在compile配置中新增一個依賴關係。

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

注意：dependencies DSL 元素是標準的 Gradle API 的一部分，不屬於android 元素內。

compile配置用於編譯主應用程式。裡面的所有內容都會被新增到編譯類路徑，並且打包到最終生成的 apk 當中。
下面是新增依賴時其他可能用到的配置： 

• compile: 主應用程式
• androidTestCompile: 測試的應用程式
• debugCompile: debug Build Type
• releaseCompile: release Build Type.

因為不可能構建一個沒有任何關聯的Build Type的 APK，apk 總是配置兩個（或以上）的配置：compile和<buildtype>Compile。 
建立一個新的Build Type會基於它的名字自動建立一個新的配置。

這可能會有用，比如debug版本需要使用一個自定義庫（例如報告崩潰的資訊），而release版本則不需要，或者是他們依賴於同一個庫的不同版本的情況下。 

遠端檔案

Gradle 支援從 Maven 和 Ivy 倉庫中拉取檔案。

首先，這個倉庫必須新增到列表當中，然後必須用Maven 或 Ivy 宣告檔案的方式宣告這個依賴。

repositories {     mavenCentral() } dependencies {     compile 'com.google.guava:guava:11.0.2' } android { ... }

注： mavenCentral()是指定maven中央倉庫的URL的快捷方法。Gradle支援遠端和本地倉庫。
注：Gradle 將遵循所有依賴關係的傳遞性。這意味著，如果一個依賴有它自己的依賴關係，這些依賴也會被拉取。

有關設定依賴關係的更多資訊，請參閱 Gradle 使用者指南（這裡），和DSL文件（這裡）。

多專案設定

Gradle 專案也可以通過使用多專案設定依賴於其他的 Gradle 專案。

一個多專案設定通常是通過讓所有的專案作為給定根專案的子資料夾來實現。

例如，給定以下專案結構：

MyProject/  + app/  + libraries/     + lib1/     + lib2/

我們可以識別出3個專案。Gradle 將通過以下名稱引用它們：

:app :libraries:lib1 :libraries:lib2

每一個專案都有其自己的build.gradle檔案，定義自己如何構建。
此外，在根路徑下還將有一個叫settings.gradle的檔案用於宣告所有的專案。
這些檔案的結構如下：

MyProject/  | settings.gradle  + app/     | build.gradle  + libraries/     + lib1/        | build.gradle     + lib2/        | build.gradle

settings.gradle的內容很簡單：

include ':app', ':libraries:lib1', ':libraries:lib2'

它定義了哪個資料夾實際上是一個 Gradle 專案。
該:app專案可能依賴於libraries，這是通過宣告如下的依賴關係來配置的：

dependencies {     compile project(':libraries:lib1') }

關於多專案設定的更多常用資訊請參閱這裡。

庫專案

在上面的多專案的設定中，:libraries:lib1和:libraries:lib2可以是Java專案，而:app Android專案將會使用到它們的jar包輸出。
但是，如果你想共享訪問了 Andr​​oid API或使用了 Android-style的資源的程式碼，這些庫專案就不能是普通的Java專案，而應該是 Andr​​oid Library 專案。

建立庫專案

Library專案與普通的 Android 專案非常相似，只有一些不同。

由於構建庫專案與構建應用程式有些不同不同，所以使用的是不同的外掛。這兩個外掛內部共享了大部分的相同的程式碼，並且它們都由同樣的com.android.tools.build.gradle jar 包提供。

buildscript {     repositories {         mavenCentral()     }     dependencies {         classpath 'com.android.tools.build:gradle:0.5.6'     } } apply plugin: 'android-library' android {     compileSdkVersion 15 }

上面的例子中建立了一個使用API​​ 15編譯的庫專案。SourceSets和依賴關係與它們在應用程式專案中的處理方式一樣，並且支援同樣方式的自定義。

普通專案和Library 專案之間的區別

一個 Library 專案主要輸出的是一個.aar包（它代表Android的歸檔檔案）。它組合了編譯程式碼（如一個jar檔案或原生的.so檔案）和資源（manifest，res，assets）。 一個庫專案還可以生成測試apk，獨立於應用程式測試這個庫。
庫專案用著同樣的錨任務（assembleDebug， assembleRelease），所以構建這樣一個專案的命令也沒有任何區別。

對於其他的內容，庫專案和應用程式專案的行為是一樣的。。他們都有構建型別（build types）和產品定製（product flavors），並且都可以生成多個版本的aar。 需要注意的是，Build Type的大部分配置都不適用庫專案。但是，您可以根據一個庫專案是否被其他專案使用還是被測試，使用自定義 sourceSet 來更改庫專案的內容。

引用一個庫專案

引用一個庫庫和引用其他任何專案的方法是一樣的：

dependencies {     compile project(':libraries:lib1')     compile project(':libraries:lib2') }

注意： 如果您有多個庫，那麼排序將非常重要。這類似於舊的生成系統中， project.properties 檔案的依賴項的順序的重要性。

庫專案釋出

預設情況下，一個庫專案只發布它的release variant。這variant將被所有引用該庫的專案使用，無論那些專案構建的是哪種variant。這是由於 Gradle 限制而有的一個臨時限制，我們正在努力消除這個問題。 您可以控制要釋出哪一個variant 

android {     defaultPublishConfig "debug" }

注意，這個釋出的配置名稱引用的是完整的 variant 名稱。release和debug，只在沒有定義flavor時適用。如果你想在使用flavors時更改預設的釋出variant，你可以這樣寫：

android {     defaultPublishConfig "flavor1Debug" }

釋出一個庫專案的所有variants也是可以做到的。我們正計劃在正常的專案對專案（project-to-project）的依賴（如上面的例子）時也可以這樣做，但現在因為 Gradle 的限制（我們也在努力修復這些問題)，還無法做到。 預設情況下沒有啟用釋出所有variant。要啟用它們可以這樣做：

android {     publishNonDefault true }

釋出多個variants意味著釋出多個aar檔案，而不是釋出一個包含多個variants的aar檔案，能意識到這一點是非常重要的。每一個 aar 包都是包含一個單一的variant。 釋出一個variant，意識著讓這個可用的 aar 作為 Gradle 專案的輸出檔案。這個檔案將會在釋出到一個maven倉庫中，或者另一個專案建立對這個專案依賴時用到。 Gradle 有一個預設檔案的概念。它就是在編寫下面的程式碼時用到的：

compile project(':libraries:lib2')

若要建立對一個專案的另一個已釋出的檔案的依賴，您需要指定使用哪一個：

dependencies {     flavor1Compile project(path: ':lib1', configuration: 'flavor1Release')     flavor2Compile project(path: ':lib1', configuration: 'flavor2Release') }

重要說明：注意已釋出的配置是一個完整的variant，包括生成型別，並且需要像以上那樣被引用。  重要說明：當啟用非預設的釋出時，Maven 釋出外掛將把這些額外的variant作為額外的包（按分類器分類）釋出。這意味著它對釋出到一個 maven 倉庫並不是真正的相容。您應該只向一個倉庫釋出一個單一的 variant，或者是，為專案之間的依賴啟用所有的釋出配置。