当前位置 博文首页 > 梦和远方:Android Gradle插件

    梦和远方:Android Gradle插件

    作者:梦和远方 时间:2021-06-22 18:25

    目录
    • 什么是Gradle
    • 编写方法
      • buildSrc
    • 基础概念
      • Extension
      • 自定义Task
      • Plugin
      • Transformer
    • Gradle用处
    • 好文章
    • 常见问题

    Gradle插件练习地址:https://github.com/peiniwan/ASMLifeCycleTest

    什么是Gradle

    Gradle 是一个基于 Apache Ant 和 Apache Maven 概念的项目自动化构建工具。Gradle 就是工程的管理,帮我们做了依赖、打包、部署、发布、各种渠道的差异管理等工作。
    Gradle脚本是基于Groovy语言来编译执行的,Java、Groovy、Kotlin等都是基于JVM运行的,所以他们在语法上共性很多,熟悉Java的同学应该对Groovy上手很快

    编写方法

    在 Android 下的 gradle 插件共分为 两大类:

    • 脚本插件:同普通的 gradle 脚本编写形式一样,可以直接写在build.gradle文件中,也可以自己新建一个 gradle 脚本文件中写
    • 对象插件:通过插件全路径类名或 id 引用,它主要有 三种编写形式,如下所示:
      1)在当前构建脚本下直接编写。
      2)在 buildSrc 目录下编写。
      3)在完全独立的项目中编写。

    buildSrc

    由于buildSrc目录是gradle默认的目录之一,该目录下的代码会在构建是自动编译打包,并被添加到buildScript中的classpath下,所以不需要任何额外的配置,就可以直接被其他模块的构建脚本所引用。
    这就是:buildScript

    在buildSrc/src/main目录下,再分别创建groovy、resources文件夹。

    随便定义的需要自己写classpath:

    优点:

    • 项目构建时,Gradle 会自动编译项目目录下的 buildSrc 文件夹下的构建脚本和源码,并将其添加到项目构建脚本的 classpath 中,因此在使用 buildSrc 中创建的插件时,无需再手动指定 classpath(依赖的名字)(当然也可以自己创建id)
    • buildSrc 文件夹中构建脚本和 Gradle 插件同一项目均可见,因此同一项目中的其他模块也可以使用 buildSrc 中创建的插件
    • 不需要 uploadArchives task

    缺点:
    此处创建的插件对外部项目不可见,无法在其他项目中复用

    id引入
    引用的方式可以是通过类名引用,也可以通过给插件映射一个id,然后通过id引用。
    通过类名引用插件的需要使用全限定名,也就是需要带上包名,或者可以先导入这个插件类,如下

    // 在app模块下的build.gradle文件中引用
    apply plugin:com.wings.gradle.CustomBuildSrcPlugin
    或者

    // 在app模块下的build.gradle文件中引用
    import com.wings.gradle.CustomBuildSrcPlugin
    apply plugin: CustomBuildSrcPlugin

    通过简单的id的方式,我们可以隐藏类名等细节,使的引用更加容易。映射的方式很简单,在buildSrc目录下创建resources/META-INF/gradle-plugins/xxx.properties,这里的xxx也就是所映射的id,这里我们假设取名CustomPlugin。具体结构可参考上文buildSrc目录结构。

    基础概念

    Extension

    为了能让 App 传入相关的版本信息和生成的版本信息文件路径,我们需要一个用于配置版本信息的 Extension,其实质就是一个实体类

    与创建扩展属性一样,扩展Task也需要在project中创建注入。

    project.extensions.create("releaseInfo", ReleaseInfoExtension)
    

    自定义Task

    右边就都是task

    • 使用自定义扩展属性 Extension 仅仅是为了让使用插件者有配置插件的能力。而插件还得借助自定义 Task 来实现相应的功能
    • 创建扩展属性一样,扩展Task也需要在project中创建注入
    // 创建Task
    project.tasks.create("updateReleaseInfo", ReleaseInfoTask)
    
    • task 的作用就是通过实现自定义的 Extension,可以在 Gradle 脚本中增加类似 android 这样命名空间的配置,Gradle 可以识别这种配置,并读取里面的配置内容。。
    • 一个Task表示一个逻辑上较为独立的执行过程,比如编译Java源代码,拷贝文件,打包Jar文件,甚至可以是执行一个系统命令或者调用Ant。另外,一个Task可以读取和设置Project的Property以完成特定的操作。
    • 一个Task是由一序列Action组成的,当运行一个Task的时候,这个Task里的Action序列会按照顺序执行

    构建生命周期
    每次构建的本质其实就是执行一系列的Task,某些Task可能依赖其他Task,那些没有依赖的Task总会被最先执行,而且每个Task只会被执行一遍,每次构建的依赖关系是在构建的配置阶段确定的,在gradle构建中,构建的生命周期主要包括以下三个阶段:
    初始化(Initialization)
    构建工具会根据每个build.gradle文件创建出一个Project实例,初始化阶段会执行项目根目录下的Settings.gradle文件,来分析哪些项目参与构建。
    include ':app'
    配置(Configuration)
    执行(Execution)

    Plugin

    作用

    • 模块化构建脚本的功能
    • 公共的功能可以抽取出来成为插件,可以供多个 build.gradle 使用,增加复用性。

    和task的关系
    如果有个你想要在好几个项目中重用的Gradle task集合,把这些task提取到一个自定义的plugin中是有意义的。这使得重用你自己的build逻辑和与他人共享该逻辑都是可能的。

    Transformer

    在 Booster 中,跟字节码相关的操作都是通过 Transformer 来完成,它是对字节码转换的简单抽象,以字节码的二进制做为输入,经过转换后,输出字节码二进制,它与具体使用哪种字节码操作框架无关,开发者可以自己选择跟字节码操作框架相关的特定实现, Booster 提供了两种实现:
    基于 ASM 的实现:AsmTransformer
    基于 Javassist 的实现:JavassistTransformer

    Transform 可以被看作是Gradle 在编译项目时的一个 task,在 .class 文件转换成 .dex 的流程中会执行这些 task,对所有的 .class 文件(可包括第三方库的 .class)进行转换,转换的逻辑定义在 Transform 的 transform 方法中。实际上平时我们在 build.gradle 中常用的功能都是通过 Transform 实现的,比如混淆(proguard)、分包(multi-dex)、jar 包合并(jarMerge)

    class AddCodePlugin implements Plugin<Project> {
        void apply(Project project) {
            project.android.registerTransform(new AddCodeTransform(project))
        }
    }
    

    写法

    其实就是:把输入内容写入到作为输出内容

    输出地址不是由你任意指定的。而是根据输入的内容、作用范围等由TransformOutputProvider生成,比如,你要获取输出路径:

     String dest = outputProvider.getContentLocation(directoryInput.name,
                            directoryInput.contentTypes, directoryInput.scopes, Format.DIRECTORY)
                            
    FileUtils.copyDirectory(directoryInput.file, dest)
    
    

    Transform的inputs有两种类型,一种是目录,一种是jar包,要分开遍历
    一旦注册了transform,就要处理输入和输出(默认实现是没有处理的),否则编译失败。

    字节码操作框架
    ASM vs Javassist
    https://booster.johnsonlee.io/developer/bytecode-engineering-framework.html

    Transform API 起因
    从 Android Gradle Plugin 1.5.0-beta1 开始,为了简化注入自定义 class 的操作,Android 提供了 Transform API,允许第三方插件在 class 文件被转换成 dex 之前对其进行修改,在此之前,如果要实现同样的操作,只能通过 Hook Task 的方式才能做到

    参数说明
    具体看代码
    解释说明:Transform 主要作用是检索项目编译过程中的所有文件。通过这几个方法,我们可以对自定义 Transform 设置一些遍历规则,具体如下:

    getName:
    设置我们自定义的 Transform 对应的 Task 名称。Gradle 在编译的时候,会将这个名称显示在控制台上。比如:
    Task :app:transformClassesWithXXXForDebug。

    getInputType:
    在项目中会有各种各样格式的文件,通过 getInputType 可以设置 LifeCycleTransform 接收的文件类型,此方法返回的类型是 Set<QualifiedContent.ContentType> 集合。

    Gradle用处

    gradle插件修改第三方代码

    1、我们知道在打包过程中,可以通过动态修改字节码,来进行插桩,实现埋点等业务,那么,在什么时机插入呢?
    2、随着项目越来越大,编译项目的时间会越来越长,我们需要统计各个任务的执行时间,来优化我们的打包编译速度,那么,如何统计呢?
    3、在我们的项目、第三方库和系统遇到一些bug的时候,我们有没有什么比较好的hook方法,对我们的代码做到无侵入?

    好文章

    调试gradle
    https://www.jianshu.com/p/6bbe9352f75d 也可以

    gradle插件发布

    通过自定义Gradle插件修改编译后的class文件

    Gradle插件实战之编译期修改代码

    • 开源库和自己写的插入代码注意不要混淆
    • buildSrc中build.gradle的AGP版本要和app模块中一致
    • 插入代码引用的类要使用全路径
    • 插入代码中用到的类需要将类路径添加到classPool中,否则会编译不过
      buildSrc不要在settings.gradle中配置
    • 不管我们有没有修改jar的操作,也要拷贝到目标路径

    Android ASM框架详解

    Java学习之 javassist

    自定义Gradle插件+ASM 实战

    常见问题

    • Could not find implementation class 'xxx' 的话
    implementation-class=com.lqr.gradle.study.GradleStudyPlugin
    // 如果报错 Could not find implementation class 'xxx' 的话,一般是类全路径有问题,默认包不需要写包路径,修改如下即可:
    // implementation-class=GradleStudyPlugin
    
    • 重新部署插件时,需要先在 app module 的 build.gradle 中将插件依赖注释,否则报错。
    • 不生效时,可以先注释,编译,再打开试试
    bk