5.详解build.gradle文件

    我之前所开发的java项目都是使用Maven构建的，而安卓项目则是通过gradle构建的。

    我们在之前分析安卓项目的目录结构的时候，可以看到build.gradle有两个，一个是位于最外层的，一个是位于app目录下的，这两个文件都对构建安卓项目都起着至关重要的作用。先来看看最外层的build.gradle

buildscript {
    repositories {
        google()
        jcenter()
        
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.3.0'
        
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        google()
        jcenter()
        
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

     这些代码都是自动生成的，虽然看上去有点难以理解，我们忽略它的语法结构，只看最关键的部分，首先两处repositories的闭包中都声明了jcenter()这行配置，这行配置的意思是一个代码托管库，很多的Andriod开源项目都会托管到jcenter上，声明了这行配置后，我们就可以在项目中轻松的引用任何的jcenter上的开源项目了，同理google()也是如此。

    接下来，dependencies    闭包中使用classpath    声明了一个Gradle插件。为什么要声明这个 插件呢？因为Gradle并不是专门为构建Android项目而开发的，Java、C++等很多种项目都可以使 用Gradle来构建。因此如果我们要想使用它来构建Android项目，则需要声 明com.android.tools.build:gradle:3.3.0    这个插件。其中，最后面的部分是插件的 版本号，我在写作本书时最新的插件版本是3.3.0。

    下面，我们分析一下app目录下的build.gradle,代码如下：

apply plugin: 'com.android.application'

android {
    compileSdkVersion 28
    defaultConfig {
        applicationId "example.com"
        minSdkVersion 15
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support:appcompat-v7:28.0.0'
    implementation 'com.android.support.constraint:constraint-layout:1.1.3'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'com.android.support.test:runner:1.0.2'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}

    我们逐行的分析：

    第一行

    apply plugin: 'com.android.application'，第一行应用了一个插件，一般有两个可供选择的值，com.android.application：表示这是一个应用程序的模块，是可以直接运行的。另一个可供选择的值是com.android.library，表示是一个库模块，它只能作为代码库依附于别的应用程序模块来运行。

       接下来是一个android的大闭包，在这个闭包中我们可以配置项目构建的各种属性。其中compileSdkVersion 28用于指定项目的编译版本，这里指定为28表示使用的Andriod9.0的SDK编译。然后我们看到，这里在android闭包中又嵌套了一个defaultConfig闭包    ，defaultConfig闭包中可以 对项目的更多细节进行配置。其中，applicationId    用于指定项目的包名，前面我们在创建 项目的时候其实已经指定过包名了，如果你想在后面对其进行修改，那么就是在这里修改 的。minSdkVersion    用于指定项目最低兼容的Android系统版本，这里指定成15表示最低兼容 到Android    4.0系统。targetSdkVersion    指定的值表示你在该目标版本上已经做过了充分的测 试，系统将会为你的应用程序启用一些最新的功能和特性。比如说Android    6.0系统中引入了运 行时权限这个功能，如果你将targetSdkVersion    指定成23或者更高，那么系统就会为你的 程序启用运行时权限功能，而如果你将targetSdkVersion    指定成22，那么就说明你的程序 最高只在Android    5.1系统上做过充分的测试，Android    6.0系统中引入的新功能自然就不会启用 了。剩下的两个属性都比较简单，versionCode    用于指定项目的版本号，versionName    用于
指定项目的版本名，这两个属性在生成安装文件的时候非常重要，我们在后面都会学到。分析完了defaultConfig闭包，接下来我们看一下buildTypes闭包    。buildTypes闭包中用于指定生 成安装文件的相关配置，通常只会有两个子闭包，一个是debug，一个是release。debug闭包用于 指定生成测试版安装文件的配置，release闭包用于指定生成正式版安装文件的配置。另外， debug闭包是可以忽略不写的，因此我们看到上面的代码中就只有一个release闭包。下面来看一 下release闭包中的具体内容吧，minifyEnabled    用于指定是否对项目的代码进行混淆，true 表示混淆，false    表示不混淆。proguardFiles    用于指定混淆时使用的规则文件，这里指定 了两个文件，第一个proguard-android.txt    是在Android    SDK目录下的，里面是所有项目 通用的混淆规则，第二个proguard-rules.pro    是在当前项目的根目录下的，里面可以编写 当前项目特有的混淆规则。需要注意的是，通过Android    Studio直接运行项目生成的都是测试版 安装文件，关于如何生成正式版安装文件我们将会后面学习。

       这样整个android闭包中的内容就都分析完了，接下来还剩一个dependencies闭包    。这个闭包的 功能非常强大，它可以指定当前项目所有的依赖关系。通常Android    Studio项目一共有3种依赖方 式：本地依赖、库依赖和远程依赖。本地依赖可以对本地的Jar包或目录添加依赖关系，库依赖 可以对项目中的库模块添加依赖关系，远程依赖则可以对jcenter库上的开源项目添加依赖关系。 观察一下dependencies闭包中的配置，第一行的compile    fileTree    就是一个本地依赖声明， 它表示将libs目录下所有.jar后缀的文件都添加到项目的构建路径当中。而第二行的compile    则 是远程依赖声明，com.android.support:appcompat-v7:24.2.1    就是一个标准的远程依 赖库格式，其中com.android.support    是域名部分，用于和其他公司的库做区 分；appcompat-v7    是组名称，用于和同一个公司中不同的库做区分；24.2.1是版本号，用于 和同一个库不同的版本做区分。加上这句声明后，Gradle在构建项目时会首先检查一下本地是否 已经有这个库的缓存，如果没有的话则会去自动联网下载，然后再添加到项目的构建路径当 中。至于库依赖声明这里没有用到，它的基本格式是compile    project    后面加上要依赖的库 名称，比如说有一个库模块的名字叫helper，那么添加这个库的依赖关系只需要加入compile project(':helper')    这句声明即可。另外剩下的一句testCompile    是用于声明测试用例 库的，这个我们暂时用不到，先忽略它就可以了。