1.3.6 详解build.gradle文件——Android第一行代码（第二版）笔记

不同于Eclipse，Android Studio是采用Gradle来构建项目的。Gradle是一个非常先进的项目构建工具，它使用了一种基于Groovy的领域特定语言(DSL)来声明项目设置。
首先看项目最外层目录下的build.gradle文件，代码如下所示：

buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.1.3'
    }
}
allprojects {
    repositories {
        google()
        jcenter()
    }
}
task clean(type: Delete) {
    delete rootProject.buildDir
}

这些代码是自动生成的，
首先两处，repositories的闭包中都声明了jcenter()这个配置。jcenter是一个代码托管仓库。
接下来，dependencies闭包中使用classpath声明一个Gradle插件。因为Gradle并不是专门为构建Android项目而开发的，因此如果我们要想使用它来构建Android项目，则需要声明com.android.tools.build:gradle:3.1.3这个插件。其中最后面的部分是版本号。

下面我们来看app目录下的build.gradle文件，代码如下所示：

apply plugin: 'com.android.application'

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

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support:appcompat-v7:28.0.0-alpha3'
    implementation 'com.android.support.constraint:constraint-layout:1.1.2'
    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'
}

第一行应用了一个插件，一般有两种值可选：

• com.android.application 表示这是一个应用程序模块，
• com.android.library 表示这是一个库模块。
  应用程序模块和库模块的最大区别在于，一个是可以直接运行的，一个只能作为代码库依附于别的应用程序模块来运行。

---

android闭包：在这个闭包中我们可以配置项目构建的各种属性。

• compileSdkVersion：用于指定项目构建的版本，这里指定成28标示使用Android 9.0系统的SDK编译。
• buildToolsVersion：用于指定项目构建工具的版本，目前最新的28.0.0，如果有更新的版本时，Android Studio会进行提示。修改buildToolsVersion有两种方法，
  第一种直接在app中的build.gradle里添加

android {
    compileSdkVersion 28
    buildToolsVersion '28.0.0'
    defaultConfig {}
    buildTypes {}
}

第二种方法是选中项目，然后点鼠标右键，Open Module Settings，进入里面直接更改 buildTools的版本，如图

也可以点右上角的这个图片，如图

• defultConfig闭包：可以对项目的更多细节进行配置。其中：
  applicationId：用于指定项目的包名；
  minSdkVersion：用于指定项目最低兼容的Android系统版本，这里设置成15标示最低兼容到Android 4.0系统；
  targetSdkVersion：指定的值标示你在该项目版本上已经做过了充分的测试，系统将会为你的应用程序启用一些最新的功能和特性；
  versionCode：用于指定项目的版本号；
  versionName：用于指定项目的版本名；
  API Level 与Android版本的对应关系
  | API Level | Android版本 |
  | --- | --- |
  | 28 | 9 |
  | 27 | 8.1 |
  | 26 | 8.0 |
  | 25 | 7.1.1 |
  | 24 | 7.0 |
  | 23 | 6.0 |
  | 22 | 5.1.1 |
  | 21 | 5.0.1 |
  | 20 | 4.4w.2 |
  | 19 | 4.4.2 |
  | 18 | 4.3.1 |
  | 17 | 4.2.2 |
  | 16 | 4.1.2 |
  | 15 | 4.0.3 |
  | 14 | 4.0 |
  | 10 | 2.3 |
  | 8 | 2.2 |

---

buildTypes闭包：用于指定生成安装文件的相关配置，通常只会有两个自闭包，一个是debug，一个是release。

• debug闭包：用于指定生成测试版安装文件的配置；
• release闭包：用于指定生成正式版安装文件的配置；
  minifyEnabled：用于指定是否对项目的代码进行混淆，true表示混淆，false表示不混淆；
  proguardFiles：用于指定混淆时使用的规则文件，这里指定了两个文件，第一个proguard-android.txt是Android SDK 目录下的，里面是所有项目通用的混淆规则，第二个proguard-rules.pro是在当前项目的根目录下的，里面可以编写当前项目特有的混淆规则。
  注：通过Andorid Studio直接运行项目生成的都是测试版安装文件；
  注：debug闭包是可以忽略不写的；

---

• dependencies闭包：它可以指定向前项目所有的依赖关系。
  通常Android Studio项目一共有3种依赖方式：本地依赖、库依赖、远程依赖；
  • 本地依赖：可以对本地的Jar包或目录添加依赖关系；
  • 库依赖：可以对项目中的库模块添加依赖关系；
  • 远程依赖：可以对jcenter库上的开源项目添加依赖关系；
    注：2018开始用implementation代替compile
• 第一行implementation fileTree就是一个本地依赖声明，它表示将libs目录下的所有.jar后缀的文件都添加到项目的构建路径当中。
• 第二行implementation则是远程依赖声明，com.android.support:appcompat-v7:28.0.0-alpha3就是一个标准的远程依赖库格式，其中com.android.support是域名部分，用于和其他公司库做区分：appcompat-v7是组名称，用于和同一个公司中不同的库做区分；28.0.0-alpha3是版本号，用于和同一个库不同的版本做区分。加上这句声明后，Gradle在构建项目时会首先检查一下本地是否已经有这个库的缓存，如果没有的话则去自动联网下载，然后再添加到项目的构建路径当中。
• 第三行代码implementation 'com.android.support.constraint:constraint-layout:1.1.2'声明，为了ConstraintLayout的使用（了解更多请移步这里）
• 第四行代码testImplementation是用于声明测试用例库的；

本文由博客一文多发平台 OpenWrite 发布！