Android官方技术文档翻译——Gradle 插件用户指南（4）

近期赶项目，白天基本没时间，仅仅有晚上在家的时候才干看一看。昨天晚上仅仅翻译完了第四章，今天就仅仅发第四章吧。

本文译自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

前三章见《Android官方技术文档翻译——Gradle 插件用户指南（1-3）》。

翻译工做耗时费神，假设你认为本文翻译得还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的内容很是easy：

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，或者是，为项目之间的依赖启用所有的公布配置。