Android Studio中的.gradle文件解读

###简介

一个 Android Studio 项目中，会存在多个 .gradle 文件。其中， 项目根目录下存在一个 build.gradle 文件和一个 settings.gradle 文件；每一个 module 会存在一个 build.gradle 文件。

这里只是简单的讲解一下默认生成的 .gradle 文件的内容，更多 Gradle 的知识，访问：http://tools.android.com/tech-docs/new-build-system/user-guide

##项目根目录下的build.gradle

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.2.0-alpha3'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

默认的项目根目录下的 build.gradle 文件内容如上。

buildscript ：用于设置驱动构建过程的代码。
jcenter()：声明使用 maven 仓库。在老版本中，此处为 ：mavenCentral()

• mavenCentral() ：表示依赖从 Central Maven 2 仓库中获取。
• jcenter() ：表示依赖从Bintary`s JCenter Maven 仓库中获取
• mavenLocal() ：表示依赖从本地的Maven仓库中获取。

: dependencies ：声明了使用 Android Studio gradle 插件版本。一般升级AS或者导入从Eclipse中生成的项目时需要修改下面gradle版本。具体的版本对应关系，请访问：http://tools.android.com/tech-docs/new-build-system/version-compatibility。

allprojects：设置每一个 module 的构建过程。在此例中，设置了每一个 module 使用 maven 仓库依赖。

##项目根目录下settings.gradle

include ':app'

默认的项目根目录下的 settings.gradle 文件内容如上。可有可能默认情况下， project 目录下的 settings.gradle 文件不存在，你可以自己创建。
include ‘:app’：表示当前 project 下有一个名称为 app 的 module 。

如果你的一个 module 并不是 project 根目录下，你可以这么设置。

include ':app2'
project(':app2').projectDir = new File('path/to/app2')

项目根目录下的gradle、gradlew、gradlew.bat这3个文件及文件夹我们不需要进行处理。

有一处比较特别的就是：

项目根目录下的gradle/wrapper/gradle-wrapper.properties 这个配置文件中配置了 Gradle 构建当前项目时使用的 Gradle 版本。我们需要注意的就是 Android Studio 、Gradle 、 Gradle Plugin 这3个的版本需要对应起来.

我们可以使用项目根目录下的gradlew.bat 在命令行中进行 Gradle 任务。但是，建议使用 Android Studio 的 Gradle 功能面板进行 Gradle 任务。

##默认module下的build.gradle

apply plugin: 'com.android.application'

android {
compileSdkVersion 22
buildToolsVersion "23.0.3"

defaultConfig {
    applicationId "com.suixingame.demo"
    minSdkVersion 12
    targetSdkVersion 22
    versionCode 1
    versionName "1.0"
}
buildTypes {
    release {
        minifyEnabled false
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    }
}
}

dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
compile 'com.android.support:appcompat-v7:22.2.1'
}

默认的 module 目录下的 build.gradle 文件内容如上。

apply plugin: ‘com.android.application’：表示使用 com.android.application 插件。也就是表示，这是一个 android application module 。 com.android.library 表示，这是一个 android library module 。

android：配置所有 android 构建过程需要的参数。

• compileSdkVersion：用于编译的 SDK 版本。
• buildToolsVersion：用于 Gradle 编译项目的工具版本。在 SDK 中可以查看本机已安装的版本。
• defaultConfig：Android 项目默认设置。

• applicationId：应用程序包名。

• minSdkVersion：最低支持 Android 版本。
• targetSdkVersion：目标版本。实际上应为测试环境下测试机的 Android 版本。
• versionCode: 版本号。
• versionName:版本名称。

buildTypes:编译类型。
默认有两个： release 和 debug 。我们可以在此处添加自己的 buildTypes ，可在 Build Variants 面板看到。

• minifyEnabled：是否使用混淆。
  在老版本中为 runProguard ，新版本之所换名称，是因为新版本支持去掉没使用到的资源文件，而 runProguard 这个名称已不合适了。

• proguardFiles： 使用的混淆文件，可以使用多个混淆文件。
  此例中，使用了 SDK 中的 proguard-android.txt 文件以及当前 module 目录下的proguard-rules.pro文件。

dependencies：用于配制引用的依赖。

• compile fileTree(dir: ‘libs’, include: [‘*.jar’])：引用当前 module 目录下的 libs 文件夹中的所有 .jar 文件。

• compile ‘com.android.support:appcompat-v7:22.2.1’： 引用 22.2.1版本的 appcompat-v7 （也就是常用的 v7 library 项目）。
  在 Eclipse 中，使用android support，需要在 SDK 中下载 Android Support Library。在 Android Studio中，使用 android support ，需要在 SDK 中下载Android Support Repository ，且项目中使用的版本不能大于 SDK 中的版本。