gradle学习笔记(五) Gradle初步理解

概述

有了一些Groovy基础，开始学习Gradle。
同样可以在 Gradle 官网 上下载下来，可以离线看文档，更加方便（内包含pdf文档）。

Gradle is an advanced build toolkit that manages dependencies and allows you to define custom build logic.
这是 Android官网 对Gradle的定义：
Gradle是一个高级构建工具，能很方便的管理依赖，并定义构建逻辑。

已经知道Gradle是基于Groovy，所以要把Gradle当做一个编程语言来学习，而不仅仅是一个脚本。配置一个东西的时候不再是知其然，更要去查看Gradle的API文档去知其所以然。更好的是，能够写出自己的工具类。这应该是学习Gradle的目的。

有了Groovy的基础，如何学习Gradle呢？看文档、写代码、实战、再实战。代码都是越写越熟的。
还是先从配置环境开始，再介绍自己目前对Gradle的初步理解(这块自己已经看了不少文档了)，再来实战。

1. 配置gradle环境

下载下来后，把gradle命令配置到环境变量PATH中。这样可以使用命令行来运行写好的gradle脚本。

2. 介绍简单的Gradle 命令行：

1. gradle -q projects
   查看当前Project的信息
2. gradle -q tasks
   打印当前Project全部task信息
3. gradle -q tasks --all
   打印更详细的信息
4. gradle --gui
   打开gradle GUI管理界面，可以图形化的看到该Project的各种信息

（更多请查看User Guide：Using the Gradle Command-Line）

3. Gradle初步理解

下载下来的有离线文档，学习gradle离不开对这些文档的阅读。

1. Gradle User Guide
2. DSL Reference
3. Java Doc
4. Groovy Doc

Java Doc就是Gradle的API文档，Gradle本身就是SDK，我们就可以使用SDK+API来编写程序。

已经知道Gradle基于Groovy。那么所写Gradle脚本，一定会被编译为.class文件被JVM识别运行。这样去理解Gradle可能会有些帮助。

1. 了解 Project和 Task：
- Everything in Gradle sits on top of two basic concepts: projects and - tasks.
- Every Gradle build is made up of one or more projects.
- Each project is made up of one or more tasks.

Gradle中的所有东西都是基于两个概念：project 和 tasks。
Gradle的需要至少一个project来构建工程。
每个project又是由其内定义的一个或多个task组成。

（更详细情况User Guide Chapter 14）

2. 然后看几个类加深初步理解：

• org.gradle.api.Script
  a Script object will have a delegate object attached to it.For example, a build script will have a Project instance attached to it.
  这个接口被所有的脚本类实现，并且该脚本有一个相应的代理对象。比如build.gradle类就是一个Project代理对象。上一篇 gradle学习笔记(四) Groovy高级用法 中，反编译出来的.class文件，该类确实是继承自Script的。

• org.gradle.api.Project
  This interface is the main API you use to interact with Gradle from your build file. From a Project, you have programmatic access to all of Gradle’s features.
  我们主要通过这个Project这个接口来写配置脚本。

• org.gradle.api.tasks.TaskContainer
  A TaskContainer is responsible for managing a set of Task instances.
  TaskContainer管理一系列的Task。

• org.gradle.api.Task
  A Task represents a single atomic piece of work for a build, such as compiling classes or generating javadoc.
  Task是构建过程中的单一原子任务。

这几个类一看，心里就对Gradle有一个大致的印象了。我们写的配置脚本全部对应Gradle中的一个类。

Build scripts are code。
User Guide都这么说，那就是写代码，写代码来配置脚本。全都是逻辑。SDK+API。

4. Gradle代码学习

看User Guide写代码。逐步理解Gradle。写代码时候必定是要看API文档的，API文档上的注释可以帮助我们更好的理解它。

首先明确：
When you run the gradle command, it looks for a build file in the current directory. You can use the -b option to select another build file. If you use -b option then settings.gradle file is not used.
运行gradle脚本时，它首先会在当前目录下寻找build.gradle文件。可以使用-b 命令运行其他.gradle文件。

我在gradleCode下创建test.gradle文件，使用命令行这么输入才能编译成功：

gradle -q -b /Users/baiiu/gradleLearn/gradleCode/test.gradle hello

第二点：
必须要cd到build.gradle所在的目录，才能使用gradle -q taskName执行该task。

实战：
User Guide 从 14章 Build Script Basics开始，涉及代码的介绍和如何写。前面的可以粗读。要边读边照着写代码。可以按照 学习笔记(六) 来阅读。