理解app目录中的build.gradle

在上一篇文章中，我们分析了在工程根目录中build.gradle每一行代码的含义。在创建App工程时，Android Studio还会在app目录下创建一个build.gradle文件，如下所示。本文将对其逐行进行分析。

//导入application plugin。
// apply是在Interface PluginWare中定义的method，其signature为void apply(Map<String,?> options)。
// key 'plugin'意味着可以导入plugin。此外key 'from'可以导入script.
// value 'com.android.application'为插件的名称。
// 该插件的代码实现在https://android.googlesource.com/platform/tools/build/+/android-7.0.0_r6/gradle/src/main/groovy/com/android/build/gradle/AppPlugin.groovy
apply plugin: 'com.android.application'

// 根据插件的代码实现，'android'为extension的名称。
// extension = project.extensions.create('android', AppExtension, this, (ProjectInternal) project, instantiator, buildTypeContainer, productFlavorContainer, signingConfigContainer)
// 在apply plugin: 'com.android.application'时，该插件的apply mehtod被调用，然后调用上面的代码创建了一个extension，用于收集配置属性。
// 关于这些配置属性的详细解释，可以参考官方文档(http://google.github.io/android-gradle-dsl/current/com.android.build.gradle.AppExtension.html#com.android.build.gradle.AppExtension)
android {
     // 下面这两个必需项必须与所安装的SDK一致，否则报错。
    // 必需项：SDK版本
    compileSdkVersion 23
    // 必需项：编译工具版本
    buildToolsVersion "23.0.1"

    // 默认配置，其类型为ProductFlavor，所有的product flavors共享这些配置。
    defaultConfig {
        // 在手机和Google Play中唯一识别app的id。
        // aapt dump badging命令所导出的package name就是在这定义的。这个与AndroidManifest.xml中的定义的package还是有所区别的。
// applicationId是手机和Google Play中唯一识别该app的id，而package则可用于组织app的resource。
        // 更多信息请参考官方文档http://tools.android.com/tech-docs/new-build-system/applicationid-vs-packagename
        applicationId "com.apkudo.uiautomatordemo"
        // 下面这四项在AndroidManifest.xml中定义的值会被此处的值覆盖掉。
        // 为了避免歧义，建议还是只在此处定义。
        minSdkVersion 19
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"
        // For Uiautomator test.
        // 这个是为使用Uiautomator进行测试而添加的，指定使用AndroidJUnitRunner作为test runner.
        // testInstrumentationRunner是ProductFlavor中定义的属性，可以根据Flavor进行定制。
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }

    // 本工程所用的编译类型。
    // 根据http://tools.android.com/tech-docs/new-build-system/user-guide, 插件中默认定义了release和debug两种类型。
    buildTypes {
        release {
            // 不对apk大小进行优化。如果使能的话，可以使用ProGuard将未使用的代码及资源不打入apk中。
            minifyEnabled false
            // 设置所用的proguard files: 从SDK中获取默认的proguard-android.txt，和本地定义的proguard-rules.pro。
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

// 该app所依赖的库。
dependencies {
     // 'compile'为编译app时所用的库
    // 使用本地libs目录中的所有jar文件作为库
    compile fileTree(dir: 'libs', include: ['*.jar'])
    // 使用jcenter repositories中的Android支持包，格式为groupid:artifactid:version。
    compile 'com.android.support:appcompat-v7:23.1.1'

    // 'androidTestCompile'为编译测试程序时所用的库。
    androidTestCompile 'com.android.support:support-annotations:23.1.1'
    androidTestCompile 'com.android.support.test:runner:0.5'
    // Set this dependency to use JUnit 4 rules
    androidTestCompile 'com.android.support.test:rules:0.5'
    // Set this dependency to build and run UI Automator tests
    androidTestCompile 'com.android.support.test.uiautomator:uiautomator-v18:2.1.2'

}

总结一下，app目录中的build.gradle使用了com.android.application插件，收集编译app所需的配置项和依赖库，以在插件所定义的编译任务中使用。更多信息请参考官方文档。