Android Gradle 自定义Task 详解

转载请标明出处：http://blog.csdn.net/zhaoyanjun6/article/details/76408024

本文出自【赵彦军的博客】

一：Gradle 是什么

  • Gradle是一个基于Apache Ant和Apache Maven概念的项目自动化构建工具。
  • 它使用一种基于Groovy的特定领域语言(DSL)来声明项目设置，抛弃了基于XML的各种繁琐配置。面向Java应用为主。
  • 当前其支持的语言限于Java、Groovy、Kotlin和Scala，计划未来将支持更多的语言。基于 groovy 脚本构建，其 build 脚本使用 groovy 语言编写。

关于 gradle 相关运用，可以移步 ：Android Gradle使用总结

二：groovy 是什么

Groovy是一种动态语言，它和Java类似（算是Java的升级版，但是又具备脚本语言的特点），都在Java虚拟机中运行。当运行Groovy脚本时它会先被编译成Java类字节码，然后通过JVM虚拟机执行这个Java字节码类。

关于 groovy 相关知识，移步到这里：Groovy 使用完全解析

三：Gradle 的 Project 和 Tasks

每次构建（build）至少由一个project构成，一个project 由一到多个task构成。每个task代表了构建过程当中的一个原子性操作，比如编译，打包，生成javadoc，发布等等这些操作。

gradle : 一个 project 包含多个 task,一个 task 包含多个 Action

project
                  -- task1 （Action1、Action2...）
                  -- task2 （Action1、Action2...）
                  -- ...

四：自定义 Task

  • 格式：
 task 任务的名字 {
    //do some things
 }
  • 例子

build.gradle

//定义 task , 名字 hello
task hello{
    println "hello world"
}

//定义 task，名字 hello
task(hello2){
    println "hello world2"
}

//定义 task，名字 hello3
task (‘hello3‘){
    println "hello world3"
}
  • 在终端运行 gradle 命令

//执行 hello task
gradlew hello

//执行 hello2 task
gradlew hello2

//执行 hello3 task
gradlew hello3

五：创建Action

在上面的举例中，是一个非正式的 task , 说非正式是因为创建的 task 里面没有 action 。task 本质上又是由一组被顺序执行的 Action 对象构成，Action其实是一段代码块，类似于Java中的方法。

创建 Action 相关 API

 //在Action 队列头部添加Action
 Task doFirst(Action<? super Task> action);
 Task doFirst(Closure action);

 //在Action 队列尾部添加Action
 Task doLast(Action<? super Task> action);
 Task doLast(Closure action);

 //已经过时了，建议用 doLast 代替
 Task leftShift(Closure action);

 //删除所有的Action
 Task deleteAllActions();

小例子

build.gradle

//创建一个名字为hello的 task
task hello {

    //创建一个 Action , 添加到 Action 列表的头部
   doFirst(new Action<Task>() {
       @Override
       void execute(Task task) {
           println "action1++++++++++"
       }
   })

    //创建一个 Action , 添加到 Action 列表的头部
    doFirst {
        println "action2++++++++++"
    }

}

在 Action 列表中添加了 两个 Action , Action 列表如下图所示：

运行 hello task : gradle hello

运行结果：


action2++++++++++
action1++++++++++

leftShift 说明

leftShift 的作用和 doLast 一样，在action 列表尾部添加一个Action，只不过现在过时了，官方建议用 doLast 代替。下面举个小例子：

build.gradle

task hello {
    //在 Action 列表尾部添加一个 Action
    leftShift {
        println "+++++"
    }
}

leftShift 还有一种简洁写法，用 << 代替, 如下所示：

build.gradle

task hello <<{
    //在 Action 列表尾部添加一个 Action
    println "+++++"
}

那么问题来了，task 中的 Action 在什么时候执行？

六：Gradle 生命周期

1.初始化阶段

会去读取根工程中 setting.gradle 中的 include 信息，决定有哪几个工程加入构建，创建 project 实例，比如下面有三个工程： include ‘:app‘, ‘:lib1‘, ‘:lib2 。

2.配置阶段

会去执行所有工程的 build.gradle 脚本，配置 project对象，一个对象由多个任务组成，

此阶段也会去创建、配置task及相关信息。

3.运行阶段

根据gradle命令传递过来的task名称，执行相关依赖任务。Task 的 Action 会在这个阶段执行。

七：创建 Task 的另外一种方式

在上面讲解了创建 task 的基本方式，其实 gradle api 给我们提供了其他的方式创建 task ，下面讲解其他两种方式。

  • tasks

build.gradle


//创建 hello2 task
tasks.create("hello2"){
    doFirst {
        println "hello2+++++"
    }
}
  • 自定义 DefaultTask 子类
class MyTask extends DefaultTask {

    @TaskAction
    void action(){
        println "action1+++++"
    }
}

//创建 hello3 task
task hello3 (type: MyTask){
    doLast{
       println "action2+++++"
    }
}

运行 hello3 task： gradlew hello3

输出

action1+++++

action2+++++

八： Task 依赖

1、dependsOn

build.gradle

task task1 << {
    println "我是task1----"
}

task task2 << {
    println "我是task2----"
}

//task2 依赖 task1, 执行task2之前先执行task1
task2.dependsOn task1

执行 task2

gradlew task2

执行效果

我是task1----

我是task2----

2、mustRunAfter

两个 task 依赖


task task1 << {
    println "我是task1----"
}

task task2 << {
    println "我是task2----"
}

//task2 运行之前先运行task1
task2.mustRunAfter task1
  • 执行 task1 : gradlew task1

    我是task1----

  • 执行 task2 : gradlew task2

    我是task2----

  • 同时执行 task1、task2 : gradlew task1 task2

    我是task1----

    我是task2----

三个 task 相互依赖

build.gradle

task task1 << {
    println "我是task1----"
}

task task2 << {
    println "我是task2----"
}

task task3 << {
    println "我是task3----"
}

task2.mustRunAfter task1
task3.mustRunAfter task1
  • 执行 gradlew task1 task2 task3

    我是task1----

    我是task2----

    我是task3----

  • 执行 gradlew task1 task3 task2

    我是task1----

    我是task3----

    我是task1----

在出现语法矛盾的情况下，依赖关系形成闭环，编译器会报错

task1.mustRunAfter task2
task2.mustRunAfter task1

3、shouldRunAfter

形成依赖关系可有可无。

build.gradle

task task1 << {
    println "我是task1----"
}

task task2 << {
    println "我是task2----"
}

task1.shouldRunAfter task2

运行： gradlew task1 task2

我是task2----

我是task1----

在出现语法矛盾的情况下，依赖关系形成闭环，会自动打破闭环。不会报错

九：系统默认 task

gradle 默认提供了很多 task 给我们使用，比如 copy、delete

1、copy

build.gradle


task 任务的名字 (type: Copy) {
    //action
}
  • Api 介绍

//数据源目录，多个目录
public AbstractCopyTask from(Object... sourcePaths)  

//目标目录，单一
public AbstractCopyTask into(Object destDir) 

//过滤文件 包含
public AbstractCopyTask include(String... includes)

//过滤文件 排除
public AbstractCopyTask exclude(String... excludes)

//重新命名，老名字 新名字
public AbstractCopyTask rename(String sourceRegEx, String replaceWith)

//删除文件 Project 接口
boolean delete(Object... paths);

小例子：

  • 复制图片：单一数据源

task copyImage(type: Copy) {
    from ‘C:\\Users\\yiba_zyj\\Desktop\\gradle\\copy‘
    into ‘C:\\Users\\yiba_zyj\\Desktop‘
}
  • 复制图片：多个数据源

task copyImage(type: Copy) {
    from ‘C:\\Users\\yiba_zyj\\Desktop\\gradle\\copy‘ ,
         ‘C:\\Users\\yiba_zyj\\Desktop\\gradle\\copy‘

    into ‘C:\\Users\\yiba_zyj\\Desktop‘
}
  • 复制图片：过滤文件

只会复制后缀为 .jpg 的文件


task copyImage(type: Copy) {
    from ‘C:\\Users\\yiba_zyj\\Desktop\\gradle\\copy‘
    into ‘C:\\Users\\yiba_zyj\\Desktop‘
    include "*.jpg"
}
  • 复制文件：过滤文件，重命名

task copyImage(type: Copy) {
    from ‘C:\\Users\\yiba_zyj\\Desktop\\gradle\\copy‘
    into ‘C:\\Users\\yiba_zyj\\Desktop‘
    include "*.jpg"
    exclude "image1.jpg"
    rename("image2.jpg","123.jpg")
}

文件覆盖规则

相同文件覆盖

Copy 类的继承图

Copy (类)
   - AbstractCopyTask (抽象类)  (from、 into、 include、rename)
      -ConventionTask(抽象类)
       - DefaultTask (类)
        - AbstractTask (抽象类)
           - TaskInternal (接口)
            - Task(接口)
              -Comparable<Task>, ExtensionAware(接口)
                -Project(接口)    (delete 方法)

2、Delete

  • 删除 Android 更目录的aaa 文件

build.gradle


task deleteFile(type: Delete) {
    //删除Android 更目录的aaa 文件
    delete ‘../aaa‘
}
  • 删除桌面上的文件

build.gradle


task deleteFile(type: Delete) {
    //删除系统桌面 delete
    delete "C:\\Users\\yiba_zyj\\Desktop\\gradle\\delete"
}

十：小技巧

1、自定义 task 的名字用驼峰命名法

build.gradle


task deleteFile{
    //do some things
}

运行

gradlew dF 等价 gradlew deleteFile

打包时候运行 gradlew assembleRelease,可以简写成 gradlew aR

2、常见的 gradlew 命令

查看项目所有默认自带的 task，不包括自定义 task

gradlew tasks

查看所有 task (默认 task + 自定义task)

gradlew tasks --all

查看某个 task 的相关信息,这些结果包含了任务的路径、类型以及描述信息等

gradlew help --task taskName

查看 gradle 版本

gradlew -version

3、给task 添加描述 description


task task1 << {
    description = "这是一段描述信息"
    println "我是task1----"
}

十一：Gradle 环境变量配置

在上面的介绍中，运行 task 的方式是用 gradlew , 那我们怎么用 gradle 。如果在终端运行 gradle 就会提示 gradle 不是内部或外部命令，也不是可运行的程序或批处理文件。


‘gradle‘ 不是内部或外部命令，也不是可运行的程序或批处理文件。

官网下载：http://services.gradle.org/distributions/

下载完成后，我将压缩包解压放在 d 盘的 soft 目录中。

环境变量

  • GRADLE_HOME

D:\soft\gradle-4.3-all

  • Path

    D:\soft\gradle-4.3-all\gradle-4.3\bin

参考资料

1、Android Gradle 必备实用技巧

2、Android Gradle使用总结

3、Groovy 使用完全解析

4、深入理解 Android Gradle 详解


个人微信号：zhaoyanjun125 , 欢迎关注

时间： 2024-10-14 08:16:55

Android Gradle 自定义Task 详解的相关文章

给 Android 开发者的 RxJava 详解

作者:扔物线 前言 我从去年开始使用 RxJava ,到现在一年多了.今年加入了 Flipboard 后,看到 Flipboard 的 Android 项目也在使用 RxJava ,并且使用的场景越来越多 .而最近这几个月,我也发现国内越来越多的人开始提及 RxJava .有人说『RxJava 真是太好用了』,有人说『RxJava 真是太难用了』,另外更多的人表示:我真的百度了也谷歌了,但我还是想问: RxJava 到底是什么? 鉴于 RxJava 目前这种既火爆又神秘的现状,而我又在一年的使用

Android开发之InstanceState详解

Android开发之InstanceState详解 本文介绍Android中关于Activity的两个神秘方法:onSaveInstanceState() 和 onRestoreInstanceState(),并且在介绍这两个方法之后,再分别来实现使用InstanceState保存和恢复数据功能.Android实现屏幕旋转异步下载效果这样两个示例. 首先来介绍onSaveInstanceState() 和 onRestoreInstanceState() .关于这两个方法,一些朋友可能在Andr

转：给 Android 开发者的 RxJava 详解

转自:  http://gank.io/post/560e15be2dca930e00da1083 评注:多图解析,但是我还是未看懂. 前言 我从去年开始使用 RxJava ,到现在一年多了.今年加入了 Flipboard 后,看到 Flipboard 的 Android 项目也在使用 RxJava ,并且使用的场景越来越多 .而最近这几个月,我也发现国内越来越多的人开始提及 RxJava .有人说『RxJava 真是太好用了』,有人说『RxJava 真是太难用了』,另外更多的人表示:我真的百度

Android开发之InstanceState详解(转)---利用其保存Activity状态

Android开发之InstanceState详解 本文介绍Android中关于Activity的两个神秘方法:onSaveInstanceState() 和 onRestoreInstanceState(),并且在介绍这两个方法之后,再分别来实现使用InstanceState保存和恢复数据功能.Android实现屏幕旋转异步下载效果这样两个示例. 首先来介绍onSaveInstanceState() 和 onRestoreInstanceState() .关于这两个方法,一些朋友可能在Andr

转：android Support 兼容包详解

本文转自stormzhang的ANDROID SUPPORT兼容包详解 背景 来自于知乎上邀请回答的一个问题Android中AppCompat和Holo的一个问题?, 看来很多人还是对这些兼容包搞不清楚,那么干脆写篇博客吧. Support Library 我们都知道Android一些SDK比较分裂,为此google官方提供了Android Support Library package 系列的包来保证高版本sdk开发的向下兼容性, 所以你可能经常看到v4,v7,v13这些数字,首先我们就来理清

ANDROID L——Material Design详解（UI控件）

转载请注明本文出自大苞米的博客(http://blog.csdn.net/a396901990),谢谢支持! Android L: Google已经确认Android L就是Android Lollipop(5.0). 前几天发现Android5.0正式版的sdk已经可以下载了,而且首次搭载Android L系统的Nexus 6和 Nexus 9也即将上市. 所以是时候开始学习Android L了! 关于Android L如何配置模拟器和创建项目,如果大家有兴趣的话可以看看我之前的一篇文章: A

Android 开发 之 Fragment 详解

作者 : 韩曙亮 转载请著名出处 : http://blog.csdn.net/shulianghan/article/details/38064191 1. Fragement 概述 Fragement 与 Activity 生命周期关系 : Fragement 嵌入到 Activity 组件中才可以使用, 其生命周期与 Activity 生命周期相关. -- stop 与 destroy 状态 : Activity 暂停 或者 销毁的时候, 其内部嵌入的所有的 Fragement 也会执行

Android开发之WebView详解

概述: 一个显示网页的视图.这个类是你可以滚动自己的Web浏览器或在你的Activity中简单地显示一些在线内容的基础.它使用了WebKit渲染引擎来显示网页,包括向前和向后导航的方法(通过历史记录),放大和缩小,执行文本搜索等. 需要注意的是:为了让你的应用能够使用WebView访问互联网和加载网页,你必须添加Internet的权限在Android Manifest文件中: <uses-permission android:name="android.permission.INTERNE

Android Paint之PathEffect详解

尊重原创,转载请标明出处    http://blog.csdn.net/abcdef314159 在之前讲Android Paint的使用详解的时候,其中有一个方法setPathEffect(PathEffect effect)没有详细介绍,这篇就结合代码来介绍一下,在之前说过PathEffect共有6个子类ComposePathEffect,CornerPathEffect,DashPathEffect,DiscretePathEffect,PathDashPathEffect,SumPat