美文网首页
Gradle插件编写

Gradle插件编写

作者: From64KB | 来源:发表于2020-11-20 12:05 被阅读0次

Gradle插件本质就是一堆能够被复用的task的集合,就像抽取工具类一样。为了能写出一个可以发布的插件,先一步一步来。按照Gradle官方的文档中插件可以分为三种类型:

  1. Build script,写在build script中的插件。即直接在build.gradle中写的插件,便于理解。先写一个简单的GreetingPlugin插件,作用是增加一个叫hello的task,功能是在hello task执行完成后输出一段'Hello from the GreetingPlugin' 的log,上代码:
class GreetingPlugin implements Plugin<Project> {
    void apply(Project project) {
        project.task('hello') {
            doLast {
                println 'Hello from the GreetingPlugin'
            }
        }
    }
}

// Apply the plugin(应用该插件)
apply plugin: GreetingPlugin

运行结果shi:

> gradle -q hello
Hello from the GreetingPlugin

有时候还需要根据任务的不通向gradle插件中传入参数,比如是否开启该插件,或者文件路径等等,这个在平时的项目中使用也很多。如何做到呢?大体思路是先定一个包含需要传递信息的类,然后在插件中根据提供的配置生成这个类的对象。比如要在上面的GreetingPlugin插件可以传入自定义的信息,而不是写死的'Hello from the GreetingPlugin' 。可以这么做:

class GreetingPluginExtension {//定义包含需要传递信息的类
    String message = 'Hello from GreetingPlugin'
}

class GreetingPlugin implements Plugin<Project> {
    void apply(Project project) {
        // Add the 'greeting' extension object(获取叫greeting的对象)
        def extension = project.extensions.create('greeting', GreetingPluginExtension)
        // Add a task that uses configuration from the extension object
        project.task('hello') {
            doLast {
                println extension.message//输出GreetingPluginExtension类greeting对象的信息
            }
        }
    }
}

apply plugin: GreetingPlugin

// Configure the extension
greeting.message = 'Hi from Gradle'

那如果不是仅仅传递一个字符串,要传入更多的数据,比如两个字符串或者一个字符串一个boolean值呢?这里以两个字符串举例,思路还是一样的。见代码:

class GreetingPluginExtension {
    String message
    String greeter
}

class GreetingPlugin implements Plugin<Project> {
    void apply(Project project) {
        def extension = project.extensions.create('greeting', GreetingPluginExtension)
        project.task('hello') {
            doLast {
                println "${extension.message} from ${extension.greeter}"
            }
        }
    }
}

apply plugin: GreetingPlugin

// Configure the extension using a DSL block(配置对象)
greeting {
    message = 'Hi'
    greeter = 'Gradle'
}

只不过这里greeting对象的初始化和前面提到的有点不一样,

greeting {
    message = 'Hi'
    greeter = 'Gradle'
}

greeting.message = 'Hi from Gradle'//对比,其实这里也可以写成上面的形式
greeting {
    message = 'Hi from Gradle'
}

这样看起来是不是就熟悉多了?这就是一个插件基本构成,无论是这种简单的形式还是下面更通用的形式,gradle插件的编写都遵循这个最基本的逻辑。你也可以把这个gradle脚本发布到服务器上,使用apply plugin:"<脚本地址>"的方式来多项目远程依赖。
如果把这个插件单独在写build.gradle里面的代码的时候有没有想过一个问题,如果我想在这里使用其他Java库比如Gson怎么办?如果是在

dependencies {
    implementation "com.google.code.gson:gson:2.8.6"
}

这里是给项目里用的,对于build.gradle本身而言并没有效果,因为在dependencies会参与project的编译而不是build.gradle编译。解决问题的方法是在buildScript里面加入需要的库(这里是build.gradle.kts,调用方法和build.gradle有点不一致):

buildscript {
    repositories {
        mavenCentral()
    }

    dependencies.classpath("com.google.code.gson:gson:2.8.6")
}

那么就可以在build.gradle里使用Gson了:


image.png
  1. buildSrc project,写在buildSrc 工程里的插件。即在rootProjectDir/buildSrc/src/main/java directory (或者 rootProjectDir/buildSrc/src/main/groovy 或者 rootProjectDir/buildSrc/src/main/kotlin)文件夹下的插件。为什么是这个文件夹?Gradle里面约定的,仅此而已。
    先来根据上面的路径创建目录:
├── buildSrc
│   ├── build.gradle
│   └── src
│       ├── main
│       │   └── java
│       │       └── com
│       │           └── enterprise
│       │               ├── Deploy.java
│       │               └── DeploymentPlugin.java

插件不仅可以用Groovy写也可以用Java或者Kotlin写,但是要注意,对应的语言要放在对应的文件夹下(Gradle官方推荐这么做,考虑到性能和方便开发者查看):

├── build.gradle
└── src
    └── main
        ├── java
        │   └── HelloWorld.java
        └── kotlin
        │    └── Utils.kt
         └── groovy
            └── Utils.groovy

回到具体插件的编写,如果在java目录下写了一个DeploymentPlugin.java,在具体需要使用的build.gradle中apply plugin:DeploymentPlugin就好。这又是怎么做到的?Gradle是如何将DeploymentPlugin插件依赖过来的?
Gradle发现存在buildSrc目录后会编译该目录,将里面的插件生成一个buildSrc.jar。所有的gradle.build的buildsrcipt{}默认会去加载这个classpath,也就可以查找到编写的插件。好buildSrc就介绍到这里。

  1. Standalone project,独立插件项目,这个就是可以发布给任意项目使用的gradle插件,比如项目中的com.android.application等等。
    如果上面的流程都搞通了,发布插件仅仅是多了一点配置而已。重点是关注插件的编写,需要相关资料可以参考https://docs.gradle.org/current/userguide/custom_plugins.html#sec:custom_plugins_standalone_project
    相关资料,都是机械的配置即可,没有什么特别的技巧。

相关文章

  • 启用Gradle远程调试

    在Gradle学习10——自定义Gradle插件 这篇文章中介绍了编写插件的几种方式。编写gradle对象插件的实...

  • gradle插件调试

    在Gradle学习10——自定义Gradle插件 这篇文章中介绍了编写插件的几种方式。编写gradle对象插件的实...

  • 两种形式的安卓字节码插桩

    字节码插桩发生时机 首先需要编写gradle插件 由上图可知,gradle插件可以由三种方式编写: 直接在.gra...

  • Gradle插件编写

    插件编写的3总方式 1、直接在gradle文件里面编写,插件逻辑简单。2、新建一个项目,但是不用发布到市场。3、新...

  • Gradle插件编写

    Gradle插件本质就是一堆能够被复用的task的集合,就像抽取工具类一样。为了能写出一个可以发布的插件,先一步一...

  • Gradle之自定义插件的三种形式(六)

    自定义Gradle插件主要有三种形式,分别是build.gradle中编写、buildSrc工程项目中编写、独立项...

  • Gradle插件编写概述

    文章来源自作者的Android进阶计划(https://github.com/SusionSuc/Advanced...

  • Gradle - Custom Plugins

    自定义插件有三种方式 Build script 在 build.gradle 脚本中直接编写插件。插件被包含在构建...

  • Android Gradle 插件编写指南

    随着Android的发展,性能优化、组件化等等不少开发工作不得不在编译的过程中依赖对Java字节码的修改,这就要求...

  • gradle自定义插件趟坑

    按照网上的一些教程,编写了个gradle插件的demo... 。apply插件时出现以下问题: Error:(4,...

网友评论

      本文标题:Gradle插件编写

      本文链接:https://www.haomeiwen.com/subject/pkfdiktx.html