Gradle系列(二) Gradle執(zhí)行順序和task

0. 前情提示

Gradle系列已完成,專注于Gradle,有如下幾篇文章

1. 什么是gradle

維基百科:Gradle是一個基于Apache Ant和Apache Maven概念的項目自動化建構工具。它使用一種基于Groovy的特定領域語言來聲明項目設置，而不是傳統(tǒng)的XML。當前其支持的語言限于Java、Groovy和Scala，計劃未來將支持更多的語言。

按我的理解,通俗一點講,就是拿來構建項目的,我們平時在Android Studio上開發(fā)Android項目就是用Gradle進行構建的,相比于傳統(tǒng)的xml方式,我感覺更加靈活.畢竟,可以寫代碼,根據(jù)不同的環(huán)境搞些騷操作.

gradle里面其實需要學習的有3個

剛哥說過,遇到不會的直接查官方文檔,不要每次去搜索引擎東搜西搜,這樣效率很低.

這里插播一個小知識點,如何查詢官方文檔.比如在gradle中經(jīng)常用的buildscript到底是什么?來到官方文檔首頁,點開頂部INDEX,搜索buildscript,即可找到這個東西是解釋.

2. gradle項目結構

首先我們來新建一個Android項目,什么都不要動.

QZLQBT.png
  • 最外層setting.gradle為根項目的配置,可以知道需要包含哪些模塊,然后最外層的build.gralde也是根項目的配置.模塊中的build.gradle是子項目的配置.
  • gradle文件夾下面是版本配置以及gradle所需要的腳本
  • 最外層的gradlew為linux/mac下的腳本,gradlew.bat是windows下面用的腳本

3. gradle配置順序

簡單在gradle中輸出語句,看看配置順序

//settings.gradle
println("setting 開始配置")
include ':app'
rootProject.name='Hello'
println("setting 配置完成")

//project build.gradle
println("根build.gradle 開始配置")
buildscript {
    repositories {
    }
    dependencies {
    }
}
println("根build.gradle 配置完成")

//app build.gradle
println("app build.gradle 開始配置")

project.afterEvaluate {
    println "所有模塊都已配置完成"
}

android {
    defaultConfig {
    }
    buildTypes {
    }
}

dependencies {
}
println("app build.gradle 配置完成")

打印語句寫好后,clean Project,即可執(zhí)行,輸出如下:

setting 開始配置
setting 配置完成

> Configure project :
根build.gradle 開始配置
根build.gradle 配置完成

> Configure project :app
app build.gradle 開始配置
app build.gradle 配置完成
所有模塊都已配置完成

可以看到首先是配置setting,知道有哪些模塊.然后是配置根項目的build.gradle,然后才是子項目的build.gradle配置.

我在上面加了一個監(jiān)聽器project.afterEvaluate,可以通過查詢官方文檔了解它的詳細內(nèi)容,這是一個當所有的模塊都配置完了的時候的回調(diào).

其中,還可以在settings.gradle中添加一個監(jiān)聽器

gradle.addBuildListener(new BuildListener() {
    @Override
    void buildStarted(Gradle gradle) {
        println("buildStarted------------")
    }

    @Override
    void settingsEvaluated(Settings settings) {
        println("settingsEvaluated------------")
    }

    @Override
    void projectsLoaded(Gradle gradle) {
        println("projectsLoaded------------")
    }

    @Override
    void projectsEvaluated(Gradle gradle) {
        println("projectsEvaluated------------")
    }

    @Override
    void buildFinished(BuildResult result) {
        println("buildFinished------------")
    }
})

在執(zhí)行構建的時候,這個監(jiān)聽器會監(jiān)聽到主要的生命周期事件,看名字大概就能大概猜出是什么意思,buildStarted已過時.也可以看看官方文檔詳細了解

加入之后打印如下:

setting 開始配置
setting 配置完成
settingsEvaluated------------
projectsLoaded------------

> Configure project :
根build.gradle 開始配置
根build.gradle 配置完成

> Configure project :app
app build.gradle 開始配置
app build.gradle 配置完成
所有模塊都已配置完成
projectsEvaluated------------

buildFinished------------

4. gradle task

4.1 初識task

gradle中所有的構建工作都是由task完成的,它幫我們處理了很多工作,比如編譯,打包,發(fā)布等都是task.我們可以在項目的根目錄下,打開命令行(AS自帶,底部有Terminal,打開就行)執(zhí)行gradlew tasks查看當前項目所有的task.

在命令行如果執(zhí)行失敗,則將項目的JDK location設置成本地jdk的路徑,而且jdk的版本還需要是java 8. 我用的jdk版本是1.8.0_231.

> Task :tasks

------------------------------------------------------------
Tasks runnable from root project
------------------------------------------------------------

Android tasks
-------------
androidDependencies - Displays the Android dependencies of the project.
signingReport - Displays the signing info for the base and test modules
sourceSets - Prints out all the source sets defined in this project.

Build tasks
-----------
assemble - Assemble main outputs for all the variants.
assembleAndroidTest - Assembles all the Test applications.
build - Assembles and tests this project.
buildDependents - Assembles and tests this project and all projects that depend on it.
buildNeeded - Assembles and tests this project and all projects it depends on.
bundle - Assemble bundles for all the variants.
clean - Deletes the build directory.
cleanBuildCache - Deletes the build cache directory.
compileDebugAndroidTestSources
compileDebugSources
compileDebugUnitTestSources
compileReleaseSources
compileReleaseUnitTestSources

Build Setup tasks
-----------------
init - Initializes a new Gradle build.
wrapper - Generates Gradle wrapper files.

Cleanup tasks
-------------
lintFix - Runs lint on all variants and applies any safe suggestions to the source code.

Help tasks
----------
buildEnvironment - Displays all buildscript dependencies declared in root project 'Hello'.
components - Displays the components produced by root project 'Hello'. [incubating]
dependencies - Displays all dependencies declared in root project 'Hello'.
dependencyInsight - Displays the insight into a specific dependency in root project 'Hello'.
dependentComponents - Displays the dependent components of components in root project 'Hello'. [incubating]
help - Displays a help message.
model - Displays the configuration model of root project 'Hello'. [incubating]
projects - Displays the sub-projects of root project 'Hello'.
properties - Displays the properties of root project 'Hello'.
tasks - Displays the tasks runnable from root project 'Hello' (some of the displayed tasks may belong to subprojects).

Install tasks
-------------
installDebug - Installs the Debug build.
installDebugAndroidTest - Installs the android (on device) tests for the Debug build.
uninstallAll - Uninstall all applications.
uninstallDebug - Uninstalls the Debug build.
uninstallDebugAndroidTest - Uninstalls the android (on device) tests for the Debug build.
uninstallRelease - Uninstalls the Release build.

Verification tasks
------------------
check - Runs all checks.
connectedAndroidTest - Installs and runs instrumentation tests for all flavors on connected devices.
connectedCheck - Runs all device checks on currently connected devices.
connectedDebugAndroidTest - Installs and runs the tests for debug on connected devices.
deviceAndroidTest - Installs and runs instrumentation tests using all Device Providers.
deviceCheck - Runs all device checks using Device Providers and Test Servers.
lint - Runs lint on all variants.
lintDebug - Runs lint on the Debug build.
lintRelease - Runs lint on the Release build.
lintVitalRelease - Runs lint on just the fatal issues in the release build.
test - Run unit tests for all variants.
testDebugUnitTest - Run unit tests for the debug build.
testReleaseUnitTest - Run unit tests for the release build.

To see all tasks and more detail, run gradlew tasks --all

可以看到,這里有很多的task.比如我們在命令行執(zhí)行gradlew clean就是clean.執(zhí)行gradlew installDebug就是構建debug項目然后安裝到手機上.

4.2 編寫task

書寫task非常簡單,比如我們在根目錄的build.gradle中加入一個hello的task

task hello() {
    println "hello world"

    //將給定的閉包 添加到此task操作鏈表的開頭
    doFirst {
        println "hello task doFirst"
    }

    doLast {
        println "hello task doLast"
    }
}

然后在命令行執(zhí)行gradlew hello,輸出如下

setting 開始配置
setting 配置完成

> Configure project :
根build.gradle 開始配置
hello world
根build.gradle 配置完成

> Configure project :app
app build.gradle 開始配置
app build.gradle 配置完成

> Task :hello
hello task doFirst
hello task doLast

它會先配置完成,才會執(zhí)行.在一個task內(nèi)部其實擁有一個action列表,執(zhí)行的時候其實就是執(zhí)行這個列表,它的類型是一個List.上面的doFirst和doLast就是創(chuàng)建action的兩個方法,文檔.doFirst是在最開始執(zhí)行,doLast是在最后執(zhí)行,大括號里面?zhèn)魅氲氖情]包.

4.3 task執(zhí)行順序

task是有執(zhí)行順序的,在創(chuàng)建完Android項目之后,根目錄下的build.gradle中,有一個clean的task.這個是AS自動給我們生成的.

task clean(type: Delete) {
    delete rootProject.buildDir
}

我們先在根目錄下創(chuàng)建test.txt文件,然后我們在這個task中做一些改動,執(zhí)行到clean這個task時刪除根目錄下的test.txt文件.

task clean(type: Delete) {
    delete rootProject.buildDir

    doLast {
        def file = new File('test.txt')
        delete file
        println "清理"
    }
}

然后我們在hello這個task的下面寫上

hello.dependsOn clean

這樣就表示hello這個task依賴clean這個task,當執(zhí)行hello這個task時需要先執(zhí)行clean.
我們在命令行執(zhí)行gradlew hello看看是不是這樣.我執(zhí)行之后它的輸出是

> Task :clean
清理

> Task :hello
hello task doFirst
hello task doLast

先執(zhí)行clean,再執(zhí)行hello這個task.而且還看到test.txt文件被刪除(如果看到?jīng)]刪除,刷新一下看看)了,那么說明確實是clean先執(zhí)行.

這個順序有什么用?其實是很有用的,比如執(zhí)行安裝task的時候,肯定會先執(zhí)行編譯,打包這些步驟.

4.4 自帶 gradle task

當我們在AS中創(chuàng)建Android項目的時候,默認會帶一些Android的一些gradle task,這些task都是gradle和Android Gradle Plugin給我們創(chuàng)建好的,可以直接用.

Qe1fy9.png

比如我們上面使用到的gradlew clean是用來清理項目的.和編譯相關的task主要有：build和assemble，其中build依賴assemble，也就是說執(zhí)行build之前會先執(zhí)行assemble。在Android上，會根據(jù)buildType和productFlavor的不同自動創(chuàng)建多個assembleXxx任務，如assembleDebug，assembleRelease等，assemble會依賴所有的assembleXxx任務，也就是說執(zhí)行assemble會先執(zhí)行assembleDebug，assembleRelease等一系列的assemble任務。

如果想看Android Gradle Plugin源碼,可以在app/build.gradle中的dependencies下面引入

compileOnly 'com.android.tools.build:gradle:3.5.2'

然后就可以在項目的External Libraries中看到該jar的源碼,

QeUB5R.png

比如clean這個task是在com.android.build.gradle.tasks.CleanBuildCache.java里面定義的

@TaskAction
public void clean() throws IOException {
    Preconditions.checkNotNull(buildCache, "buildCache must not be null");
    buildCache.delete();
}

通過查詢gradle官方文檔可知,@TaskAction的作用:Marks a method as the action to run when the task is executed. 將方法標記為執(zhí)行任務時要運行的動作.

5.Build script blocks

還有一個東西,就是幾乎每個項目都需要用到的地方,但是我之前卻根本不知道它真正的名字.就是Build script blocks,打開項目的根目錄的build.gradle文件.

buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.5.2'
    }
}

allprojects {
    repositories {
        google()
        jcenter()
    }
}

每個項目都需要配置這些東西,但是我們真的知道他們的含義么?

首先是buildscript,查詢文檔可知:

void buildscript?(Closure configureClosure)

Configures the build script classpath for this project.

The given closure is executed against this project's ScriptHandler. The ScriptHandler is passed to the closure as the closure's delegate.

為該項目配置構建腳本類路徑.參數(shù)是Closure,閉包.這個閉包是委托給了ScriptHandler,又去看看ScriptHandler

dependencies?(Closure configureClosure)  Configures the dependencies for the script.
repositories?(Closure configureClosure)   Configures the repositories for the script dependencies.

dependencies?是添加編譯依賴項的,repositories?是為腳本依賴項配置存儲庫.他們的配置,都是用閉包的形式.

然后dependencies?又是委托了DependencyHandler進行配置,對于怎么配置,官方還給了示例

Example shows a basic way of declaring dependencies.

 apply plugin: 'java'
 //so that we can use 'implementation', 'testImplementation' for dependencies

 dependencies {
   //for dependencies found in artifact repositories you can use
   //the group:name:version notation
   implementation 'commons-lang:commons-lang:2.6'
   testImplementation 'org.mockito:mockito:1.9.0-rc1'

   //map-style notation:
   implementation group: 'com.google.code.guice', name: 'guice', version: '1.0'

   //declaring arbitrary files as dependencies
   implementation files('hibernate.jar', 'libs/spring.jar')

   //putting all jars from 'libs' onto compile classpath
   implementation fileTree('libs')
 }

6. 總結

本文帶大家梳理了Gradle的執(zhí)行順序,Task和Build script blocks這些知識點.為了更好的認識Gradle.現(xiàn)在對Gradle了解又深了一步,而且如果以后遇到不懂的還知道到哪里去查文檔,方便快捷,不用再到處搜了.

最后編輯于 ：
?著作權歸作者所有,轉載或內(nèi)容合作請聯(lián)系作者
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務。

推薦閱讀更多精彩內(nèi)容