前言

接著學習筆記(五)，這篇文章是官方文件的筆記，和自己的一些理解。看了好幾天，終於發現一個比較能夠講清楚的邏輯：

1. User Guide第三大章都有必要看
2. 看完User Guide直接看Gradle Build Language Reference即資料夾中的dsl，馬上就能有個清晰的理解。

必須要看 User Guide 的 Chapter 25. Gradle Plugins 和 Gradle DSL。這樣一來就差不多能夠理解 Gradle是個框架，真正功能是外掛實現的 這句話了。

以下是自己的一些筆記。

Gradle DSL筆記：
先理解一些概念，以幫助你寫指令碼。
第一，

A build script is made up of zero or more statements and script blocks. Statements can include method calls, property assignments, and local variable definitions. A script block is a method call which takes a closure as a parameter. The closure is treated as a configuration closure which configures some delegate object as it executes.

Gradle指令碼都是由語句和指令碼塊組成的。
語句可以是方法呼叫，新增變數等。
語句塊是一個方法，其引數是一個閉包，該閉包將代表的是配置資訊。

1. 從Gradle DSL中大概可以看到，Gradle本身只是提供了一個框架，它的方法並不多，真正能夠完成構建任務的是相應的外掛，這點也映證了User Guide Chapter 25 Gradle Plugins的說法，真正的功能都是由外掛實現的。

2. 可以看到語句塊本身接收的是一個閉包引數，而其中描述了我們的配置資訊，回想一下Android中的配置，完全是這樣的。至此，對Gradle構建有了一個完整的認識。 當然，還是需要練習的。

UserGuide筆記 :

Chapter 14. Build Script Basics

建立你的第一個Gradle程式： Hello World。
.The gradle command looks for a file called build.gradle in the current directory. We call this build.gradle file a build script.

Chapter 16，Writing Build Scripts

org.gradle.api.Project類，它對應於build.gradle檔案，當執行build.gradle指令碼檔案時，會相應的生成該類。

• 指令碼中未定義的方法，會到project中尋找
• 指令碼中未定義的屬性，會到project中尋找

建立變數：
指令碼中有兩種變數：local variables and extra properties.

Some Groovy basics一些Groovy基礎
其中介紹了一些Groovy的基礎，和在Gradle中的應用，就是之前學的groovy基礎。

Chapter 17. More about Tasks

獲取task:
1. each task is available as a property of the project, using the task name as the property name
每一個task就是該project的一個屬性，可以通過task name來獲取該task.

2.Tasks are also available through the tasks collection.
可以通過task collections獲取

Chapter 20. The Build Lifecycle

Gradle會把這些task形成一個有向圖來構建，保證了每個都會被執行到並且只執行一次。

Build phases構建階段

1. Initialization初始化
   初始化時，Gradle會去判斷哪些應該被構建，併為這些需要構建的專案建立相應的Project物件。
2. Configuration配置
   During this phase the project objects are configured.The build scripts of all projects which are part of the build are executed.
   所有專案的build.gradle指令碼會被執行。
3. Execution執行
   Gradle determines the subset of the tasks, created and configured during the configuration phase, to be executed.
   執行在Configuration階段生成的一系列tasks。

Settings file

對應 org.gradle.api.initialization.Settings 類。

A multiproject build must have a settings.gradle file in the root project of the multiproject hierarchy. It is required because the settings file defines which projects are taking part in the multi-project build
mutiproject必須要有settings.gradle，因為settings.gradle定義了哪些project要被構建。

Multi-project builds

1.Hierarchical layouts
include 'project1', 'project2:child', 'project3:child1'
對應於該方法void include(String[] projectPaths)
'services:hotels:api' 意味著將建立3個project, services,hotels,api.

2.Flat layouts
includeFlat 'project3', 'project4'
用這種方法引入的project必須是rootProject的一級project。

監聽task

1.監聽task新增是否到Project中
You can receive a notification immediately after a task is added to a project

//tasks是taskContainer,引數是Action，查閱API理解
tasks.whenTaskAdded { task ->
    task.ext.srcDir = 'src/main/java'
}

2.監聽task執行前後
You can receive a notification immediately before and after any task is executed.

//org.gradle.api.invocation.Gradle
//org.gradle.api.execution.TaskExecutionGraph
//全是API
gradle.taskGraph.beforeTask { Task task ->
    println "executing $task ..."
}

gradle.taskGraph.afterTask { Task task, TaskState state ->
    if (state.failure) {
        println "FAILED"
    }
    else {
        println "done"
    }
}

Chapter 23. Dependency Management

23.4 新增依賴的幾種方式：

org.gradle.api.artifacts.dsl.DependencyHandler 中有更詳細的說明

1.External dependencies 外部依賴
External module dependencies are the most common dependencies. They refer to a module in an external repository.

dependencies {
  compile 'commons-lang:commons-lang:2.6'
}

2.Project dependencies 依賴專案

compile project(':someProject')

3.File dependencies 檔案依賴
compile fileTree(dir: ‘libs’, include: [‘*.jar’])

4.Excluding transitive dependencies 去除一些東西

compile("org.gradle.test.excludes:api:1.0") {
    exclude module: 'shared'
}

23.6 Repositories

You may configure any number of repositories, each of which is treated independently by Gradle.
有以下幾種倉庫：

repositories {
    mavenCentral() //Maven central repository
    jcenter() //Maven JCenter repository
    mavenLocal() //Local Maven repository,本地的Maven cache

    //Maven repositories, Adding custom Maven repository,自定義從該url倉庫中獲取依賴
    maven { 
        url "http://repo.mycompany.com/maven2"
    }
}

Chapter 25. Gradle Plugins

Gradle at its core intentionally provides very little for real world automation. All of the useful features, like the ability to compile Java code, are added by plugins.
Gradle本身提供了很少的自動化構建，所有有用的功能，都是由外掛提供的。

外掛擴充套件了project的功能，可以新增更多的DSL配置。
A plugin is simply any class that implements the Plugin interface.

新增外掛，呼叫Project.apply()方法：

apply plugin: 'java'