Gradle 笔记 - Gradle 基础

《Gradle for Android 中文版》笔记

Gradle 构建的脚本–build.gradle
Gradle 有约定优于配置的原则，即为设置和属性提供默认值。

基于 Groovy 的领域专用语言（DSL）。
Groovy 是一种基于 Java 虚拟机的动态语言。
想创建自己的任务和插件，那么对 Groovy 有更深层次的理解就显得尤为重要。

Gradle 中，最重要的两个概念是项目和任务。

当初始化构建过程时，Gradle 会基于 build 文件组装项目和任务对象。

一个任务对象包含一系列动作对象，这些动作对象之后会按顺序执行。
一个单独的动作对象就是一个待执行的代码块，它和 Java 中的方法类似。

为了简化构建过程，构建工具会新建一个动态的模型流（叫做 Directed Acyclic Graph（DAG）），所有任务都会被一个接一个地执行，不循环和重复执行。
在构建的配置阶段会生成依赖关系图，那些没有依赖的任务通常会被优先执行。

Gradle 构建通常有三个阶段：

整个项目的 build.gradle 文件：

buidscript {
	repositories {
		jcenter()
	}
	dependencies {
		classpath 'com.android.tools.build.gradle:3.5.0'
	}
}

JCenter 是一个预配置的 Marven 仓库，放在 repositories 代码块中代表被配置为整个构建过程的依赖仓库。

Android 应用插件：

apply plugin: 'com.android.application'

每一个安卓项目都应该申请该插件，通常在 app 模块的 build.gradle 文件中。
用于扩展 Gradle 构建脚本的能力。
在项目中应用一个插件，项目就可以使用该插件预定义的一些属性和任务。

Android 依赖库插件：

apply plugin: 'com.android.library'

依赖库的 build.gradle 文件需要声明应用 Android 依赖库插件。
一个模块可以是 Android 应用模块，或者是一个 Android 依赖模块，但不能二者都是，即不能同时申请上面两种插件。

当使用 Android 插件时，不仅可以配置针对 Android 的特殊约定，还可以生成只应用于 Android 的任务。

android {
	compileSdkVersion 29  // 编译的 SDK 版本
	buildToolsversion "29.0.2" // 构建工具版本
}

这是 Android 特殊约定的一部分。Android 插件为 Android 的开发需求提供了一整套的 DSL。

MyApp

Gradle 是一个不断发展的工具，新版本可能打破向后兼容性，使用 Gradle Wrapper 可以避免这个问题，并能确保构建时可重复的。

Gradle Wrapper 为 Windows 操作系统提供了一个 batch 文件（为其他操作系统提供了 shell 文件），当运行这段脚本时，需要的 Gradle 版本会被自动下载（如果不存在）和使用。这样就无需手动安装正确的 Gradle 版本。

terminal 上运行

$ gradlew -v

或在命令行中运行

$ gradlew.bat -v

查看 Gradle 版本号和其他额外参数信息。

$ gradlew tasks

打印所有可用的任务列表，添加 --all 参数，会打印每个任务对应依赖的详细介绍。

$ gradlew assembleDebug

其他还有