Android Gradle 插件中文指南

3.1 基本的build文件

最基本的Java工程，其 build.gradle 非常简单：

apply plugin: 'java'

这里应用了Gradle提供的Java插件。该插件提供了构建和测试Java应用所需的一些东西。

一个最基本的Android工程的build.gradle如下：

buildscript {
    repositories {
        mavenCentral()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:0.11.1'
    }
}

apply plugin: 'android'

android {
    compileSdkVersion 19
    buildToolsVersion "19.0.0"
}

在 Android buid file 中，有3个主要组成部分。

buildscript { ... } 部分配置了驱动构建的代码。

在该部分中，定义配置使用了 Maven 中央仓库，并且声明依赖一个 Maven artifact(构件？)。 这个 artifact 是一个包含 0.11.1 版本的 Android Gradle 插件库。

注意： 这部分的配置只会影响构建过程的代码，和你的工程没有关系。工程会定义它自己的仓库和相关依赖。稍候会详细介绍。

接下来，android 插件被应用，这和上面的Java插件是一样的。

最后，android { ... } 这部分配置了 android 构建需要的所有参数。这里也是 Android DSL 的入口点。

默认情况下，只有编译的目标SDK、构建工具的版本是必需的。就是 compileSdkVersion 和 buildtoolsVersion 两个配置属性。

compilation target 和旧构建系统中的 project.properties 文件里 target 属性是一样的。这个新的属性和以前的 target 一样，可以指定一个 int 类型( api 级别)或者 string 类的值。

重要: 你应该只应用 android 插件就好了，不要同时应用 java 插件，因为这会导致构建错误

注意： 你还需要在同目录下添加一个 local.properties 文件，并通过 sdk.dir 属性配置所需的 SDK 的路径。除此之外，你也可以设置一个名为 ANDROID_HOME 环境变量。这两种方法都差不多，你可以选择自己喜欢的。