Android - Gradle 小课堂第1课 - 入门篇

Gradle 小课堂系列
Gradle 小课堂第1课 - 入门篇
Gradle 小课堂第2课 - SourceSet

目录

• Gradle 简介
• Groovy 语言
• 如何自学

Gradle 简介

Gradle 和 Android 的关系

Gradle 是一个构建系统，用来将源代码和资源构建成 apk 或者其他产物，类似于 maven、make 之类的工具。Gradle 的强大之处在于它的高度可定制化，使用脚本来定义构建规则。Gradle 能满足 Android 复杂的构建过程，Google 在 Android Studio 中直接使用 Gradle 作为 Android 的构建系统，抛弃了原来在 Eclipse 中使用的 ADT 构建系统。当然 Gradle 作为一个独立的构建系统，也可以通过命令行直接构建 Android 项目。

Android 如何使用 Gradle

使用 Gradle 定义构建过程的最直观方式就是写脚本，将某个领域的这些脚本集合到一起打个包，并可以提供给别人下载使用，就创建了一个 Gradle 插件。Android 的构建脚本就是以插件的形式存在的，俗称 AGP(Android Gradle Plugin)，有 app plugin 和 lib plugin 两种插件，分别表示编译 apk 和编译 lib。它们负责整个 Android 构建过程，我们开发者按照插件的使用规范来使用就可以开发应用了。

Groovy 语言

Groovy 是 Gradle 的默认脚本语言（现在也可以用 Kotlin 了）。对 Groovy 语言的基本掌握有助于快速理解和写脚本。

语言简介

• Groovy 语言运行在 JVM 上。
• Groovy 代码兼容 Java 代码，也就是可以在 Groovy 中直接写 Java 代码。
• Groovy 适合作为 DSL（domain-specific language） 来使用，Android 中使用的就是 Android plugin DSL。

项目默认脚本

既然是做 Android 开发，肯定是熟悉 Java 语言，而且 Groovy 又是运行在 JVM 上的，可以说内在的运行机制与 Java 是相同的，不同的只有语法，有些语法与 Java 很不一样，容易对初学者造成困扰，这里针对新建一个项目生成的默认编译脚本 build.gradle 进行一些基本概念的讲解。

1、写在 build.gradle 中的代码为什么很多花括号？

例如

android {
    buildTypes {
        debug {
            debuggable true
            minifyEnabled false
        }
    }
}

看起来好像一堆罗列的数据配置，实际上是一些可运行的 Groovy 语句。涉及到两个语法：

1. 函数调用可以省略括号。android 其实是一个方法，不省略的时候应该这么写： android({})，省略后只剩花括号了。
2. 闭包。Groovy 中的闭包是一个开放的，匿名的代码块，可以接受参数，可以返回值，也可以赋值给变量——来自官方文档的解释。把闭包当成匿名内部类的一个方法去理解可能更好理解一些，如果了解 javascript 等其他函数语言，与它们的闭包概念是一样的。省略了参数的闭包看起来就是一对花括号。注意闭包是可以赋值给变量的，也就是说可以作为参数传递给一个方法。

因此 android { ... } 实际上是 android 这个方法的调用，这个方法只有一个参数，参数的类型是一个无参数的闭包。

2、build.gradle 第一行代码是怎么回事？

apply plugin: 'com.android.library'

它省略了一些东西，补完再看就明白了：

apply([plugin: 'com.android.library'])

再看一下 apply 方法的原型，它属于 PluginAware 接口：

void apply(Map options)

在 Groovy 中 Map 可以定义字面量，比如：[plugin: 'com.android.library']，如果 Map 是方法的第一个参数，那么可以将 map 拆开来写，也就是可以省略 []。

3、属性和伪装成属性的方法

Groovy 中的属性与 Java 使用不同的约定风格。Java 中遵循 JavaBean 的风格，属性的 getter 和 setter 方法有 get 和 set 的前缀。而在 Groovy 中属性也有 getter 和 setter，但使用的时候直接使用赋值表达式即可。看下面的例子：

android {
    defaultConfig {
        ....
        targetSdkVersion 29        // 1
        targetSdkVersion = 19      // 2
        setTargetSdkVersion(29)    // 3
    }
}

以上 3 种写法都是正确的，2 和 3 是等价的，但 1 的写法却是另外一个与属性同名的方法，也就是说同时存在 targetSdkVersion(int) 与 setTargetSdkVersion(int) 这两个方法。在 Android Studio 中，如果用 2 的写法会提示你错误，说这样写 Android Studio 可能比较懵逼无法提供更好的支持……默认使用 1 的写法，这种伪装成属性的方法调用也是 Android Gradle DSL 的目的，使这些代码看起来更像配置数据。

4、定义字符串的 N 种方法

有三种方式（与其他比较新的语言很类似）

• 双引号："包含在前后各一个引号内"，可以使用内嵌表达式的语法 "log: value={$value}"
• 单引号：'包含在前后各一个单引号内'，除了不能在内部内嵌表达式以外，与双引号版本一样。
• 三引号："""包含在前后各三个双引号内"""，该方式定义的字符串能包含回车不用写\n，“所见即所得”。还有三个单引号的版本 '''单引号版本'''，区别也是双引号版本可以内嵌表达式而单引号版本不能。

---

如何自学

1. 先找通俗易懂的文章（比如本文）有个基本概念的了解。
2. 再自己写脚本验证学到的东西。
3. 解决实际的问题 or 创造了不起的东西。

查文档

学习材料千千万，官方文档要翻烂。

• 插件的接口使用方法，就是前面提到的 DSL，在这里：Android Plugin DSL Reference。与 Android 相关的东西可以查这里。
• 而 gradle 本身的类 API 文档可以到 gradle 的官网上查看：Gradle User Manual。与 Android 无关的可以查这里。
• 另外还有 Groovy 语言文档：The Apache Groovy programming languagel。Groovy 语法可以查这里。

打印 log

打印 log 是快速验证代码效果的手段之一，学习中遇到的问题，都可以打个 log 检查和验证。

println "source set: ${it} : ${it.class}" + ', name=' + it.name

可以看到有一些特殊的 ${} 符号，这个是字符串内嵌表达式的语法，在双引号内才能使用，方便一些复杂的字符串的拼接。当然直接使用 + 来拼接也可以。