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 语句。涉及到两个语法:
- 函数调用可以省略括号。
android
其实是一个方法,不省略的时候应该这么写:android({})
,省略后只剩花括号了。 - 闭包。Groovy 中的闭包是一个开放的,匿名的代码块,可以接受参数,可以返回值,也可以赋值给变量——来自官方文档的解释。把闭包当成匿名内部类的一个方法去理解可能更好理解一些,如果了解 javascript 等其他函数语言,与它们的闭包概念是一样的。省略了参数的闭包看起来就是一对花括号。注意闭包是可以赋值给变量的,也就是说可以作为参数传递给一个方法。
因此 android { ... }
实际上是 android
这个方法的调用,这个方法只有一个参数,参数的类型是一个无参数的闭包。
2、build.gradle 第一行代码是怎么回事?
apply plugin: 'com.android.library'
它省略了一些东西,补完再看就明白了:
apply([plugin: 'com.android.library'])
再看一下 apply
方法的原型,它属于 PluginAware
接口:
void apply(Map<String,?> 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
,“所见即所得”。还有三个单引号的版本'''单引号版本'''
,区别也是双引号版本可以内嵌表达式而单引号版本不能。
如何自学
- 先找通俗易懂的文章(比如本文)有个基本概念的了解。
- 再自己写脚本验证学到的东西。
- 解决实际的问题 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
可以看到有一些特殊的 ${}
符号,这个是字符串内嵌表达式的语法,在双引号内才能使用,方便一些复杂的字符串的拼接。当然直接使用 +
来拼接也可以。