欢迎光临seo外链专员,seo网络推广专员网站

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

作者:jcmp      发布时间:2021-04-25      浏览量:0
自定义Gradle插件主要有三种形式,分

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

1. 在build.gradle中编写自定义插件

对象插件是实现了org.gradle.api.plugins接口的插件,这个接口中只定义个一个简单的apply方法,想要实现自定义插件就需要去实现org.gradle.api.plugins接口。 Groovy、Java、Kotlin都可以作为实现插件的语言,在本文的示例中,使用Groovy作为实现语言。 在实际工作中我们很少会在build.gradle中编写自定义插件,这里是为了带大家写个最简单的例子,可以最快最直接的了解什么是自定义插件。

1.1 这里使用AS来编辑,新建一个项目,在module中的build.gradle中键入以下内容:

// Apply the pluginapply plugin: GreetingPluginclass GreetingPlugin implements Plugin { void apply(Project project) { project.task('GreetingPluginTask') { doLast { println '自定义插件' } } }}

在build.gradle中自定义了一个插件GreetingPlugin,在apply方法中创建一个名称为GreetingPluginTask的任务。在AS的Terminal中输入gradlew.bat GreetingPluginTask来执行GreetingPluginTask任务。

D:\DevelopSoftWare_Location\Android_Studio\DemoWorkSpace\DefinedGradle>gradle GreetingPluginTask> Task :app:GreetingPluginTask 自定义插件BUILD SUCCESSFUL in 2s1 actionable task: 1 executed。

1.2 自定义插件扩展

再举一个简单的插件拓展例子,通过插件拓展来配置GreetingPluginTask的输出字符串,如下所示。 build.gradle。

apply plugin: GreetingPlugingreeting.message="自定义插件拓展"//2class GreetingPluginPluginExtension{ String message="from GreetingPlugin"}class GreetingPlugin implements Plugin { void apply(Project project) { def extension=project.extensions.create("greeting",GreetingPluginPluginExtension)//1 project.task('GreetingPluginTask') { doLast { println extension.message } } }}

GreetingPluginPluginExtension类中定义了message变量,GreetingPluginPluginExtension是一个Groovy Bean(类似于JavaBean)。注释1处用于添加拓展插件GreetingPluginPluginExtension到插件列表中,名称为greeting。注释2处设置GreetingPluginPluginExtension的message值。 Terminal中输入gradlew.bat GreetingPluginTask来执行GreetingPluginTask任务。

D:\DevelopSoftWare_Location\Android_Studio\DemoWorkSpace\DefinedGradle>gradle GreetingPluginTask> Task :app:GreetingPluginTask 自定义插件拓展BUILD SUCCESSFUL in 2s1 actionable task: 1 executed。

2. buildSrc工程项目

除了在build.gradle中编写的自定义插件,还可以将插件的源代码放在rootProjectDir/buildSrc/src/main/groovy目录中,Gradle会自动识别来完成编译和测试。Android Studio会找rootPrjectDir/buildSrc/src/main/groovy目录下的代码。

坑:当新建libraray module并命名为buildSrc后会提示Plugin with id'com.android.library' not found.

这是因为buildSrc是Android的保留名称,只能作为plugin插件使用,我们修改buildSrc的build.gradle文件后就不报错了。

具体流程如下:

2.1. 首先创建一个名为buildSrc的module,注意,名称必须为buildSrc。

2.2. 然后将其它不需要的文件删除,新建需要的文件夹和文件,最后的目录结构如下图所示:

2.3. 新建对应的文件和文件夹之后,工程开始会不认这个buildSrc,我们修改build.gradle:

apply plugin: 'groovy'dependencies { compile gradleApi() compile localGroovy()}

点击Sync Now,完了之后发现groovy文件夹变蓝色了

2.4. 在对应的包下面新建YolynPlugin.groovy,输入以下内容。

import org.gradle.api.Pluginimport org.gradle.api.Projectclass YolynPlugin implements Plugin { @Override void apply(Project project) { project.task('yolynplugin') { doLast { println("this is YolynPlugin") } } println("welcome to YolynPlugin") }}

2.5. 再在com.yolyn.plugin.properties文件中添加以下内容(注意这里properties的名称就是我们之后要引用这个插件时apply plugin:''引号填入的内容)。

implementation-class=YolynPlugin。

这里的YolynPlugin就是我们创建的YolynPlugin.groovy文件,一定要对应上,否则会报找不到的错误。

2.6. 在app的gradle中去引用这个插件

apply plugin: 'com.yolyn.plugin'

com.yolyn.plugin是我们之前创建的properties的名称。

重新build一下

2.7. 在terminal中可以键入命令

gradle yolynplugin 或者gradlew yolynplugin 或者gradlew.bat yolynplugin。

输出内容:

D:\DevelopSoftWare_Location\Android_Studio\DemoWorkSpace\DefinedGradleDemo1>gradle yolynplugin> Configure project :app welcome to YolynPlugin> Task :app:yolynplugin this is YolynPluginBUILD SUCCESSFUL in 2s1 actionable task: 1 executed。

疑问1 这里有一个疑问,为什么先打印出welcome to YolynPlugin,是因为doLast吗,怎么解释? 疑问2 我们再创建一个插件叫OtherPlugin.groovy。

import org.gradle.api.Pluginimport org.gradle.api.Projectclass OtherPlugin implements Plugin { @Override void apply(Project project) { project.task('otherplugin') { doLast { println("this is OtherPlugin") } } println("Welcome To OtherPlugin") }}

然后同样地在gradle-plugins中创建properties,在app下面的build.gradle引用。

在Terminal中输入gradle otherplugin

D:\DevelopSoftWare_Location\Android_Studio\DemoWorkSpace\DefinedGradleDemo1>gradle otherplugin> Configure project :app welcome to YolynPluginWelcome To OtherPlugin> Task :app:otherplugin this is OtherPluginBUILD SUCCESSFUL in 2s1 actionable task: 1 executed。

发现YolynPlugin中的apply方法也执行了

疑问3 我们把两个Plugin中的doLast去掉 我们再在Terminal中输入gradle otherplugin。

D:\DevelopSoftWare_Location\Android_Studio\DemoWorkSpace\DefinedGradleDemo1>gradle otherplugin> Configure project :app this is YolynPluginwelcome to YolynPluginthis is OtherPluginWelcome To OtherPluginBUILD SUCCESSFUL in 6s。

发现全部都打印出来了,这是为什么?

Creates a Task with the given name and adds it to this project. Calling this method is equivalent to calling task(java.util.Map, String) with an empty options map.After the task is added to the project, it is made available as a property of the project, so that you can reference the task by name in your build file. See here for more detailsIf a task with the given name already exists in this project, an exception is thrown.throws: InvalidUserDataException If a task with the given name already exists in this project.Parameters: name - The name of the task to be createdReturns: The newly created task object。

大致意思是会创建一个给定名字的task放到这个project里面,调用这个方法相当于调用这个task。

再看一下Task的doLast方法:

Adds the given closure to the end of this task's action list. The closure is passed this task as a parameter when executed.

这样就能解释了,确实是因为doLast将任务添加到project的tasks的list的最后了,所以才最后执行。具体还可以查看官方文档的Project,文档在gradle安装目录的docs里面可以找到。

==疑问二和疑问三是为什么???求解==

日后继续研究 再看第三种形式

3. 独立项目或独立Module

无论是在build.gradle中编写自定义插件,还是buildSrc项目中编写自定义插件,都只能在自己的项目中进行使用。如果想要分享给其他人或者自己用,可以在一个独立的项目中编写插件,这个项目会生成一个包含插件类的JAR文件,有了JAR文件就很容易进行分享了。

3.1 创建一个名为YolynPlugin的module

跟上面创建buildSrc一样,将其它文件删除,并创建相应的文件和文件夹,最终目录结构如下:

3.2 修改build.gradle

apply plugin:'groovy'apply plugin: 'maven'dependencies { //gradle sdk compile gradleApi() //groovy sdk compile localGroovy()}

Sync Now

3.3 在com.example.yolynplugin下创建ModuleYolynPlugin.groovy(为了和上面的YolynPlugin区分)。

import org.gradle.api.Pluginimport org.gradle.api.Projectclass ModuleYolynPlugin implements Plugin { @Override void apply(Project project) { project.task("moduleyolynplugin") { println("this is module yolynplugin") } }}

3.4 在gradle-plugins文件夹下面创建com.example.yolynplugin.properties。

implementation-class=ModuleYolynPlugin。

3.5 将代码上传到仓库或者本地,这里是放到本地

在这个module的build.gradle追加下面内容

group='com.example.yolynplugin'version='1.0.0'//group和version在后面会用到uploadArchives { repositories { mavenDeployer { //提交到远程服务器: // repository(url: "http://www.xxx.com/repos") { // authentication(userName: "admin", password: "admin") // } repository(url:uri('../repo')) } }}

上面各个参数的逻辑意义参考官方文档: https://docs.gradle.org/current/dsl/index.html 这里直接将插件上传到了本项目的根目录,点击Build之后在Gradle窗口会看到uploadArchives。

点击uploadArchives会在本地生成插件相关的文件,比如我的目录和文件如下图所示。

图中的YolynPlugin-1.0.0.jar就是我们需要的插件jar包。

3.6 去app下面的module中引用

在build.gradle中追加下面内容

apply plugin: 'com.example.yolynplugin'//properties的名字buildscript {//repositories这个模块的内容告诉gradle去什么地址下载第三方的库。 repositories{ maven { url uri('../repo') } } dependencies{ //group:pluginName:version classpath 'com.example.yolynplugin:YolynPlugin:1.0.0' }}

其中com.example.yolynplugin是group,YolynPlugin是自定义插件的名称,1.0.0是版本号。

也可以这么写:

dependencies { classpath group: 'com.example.yolynplugin', name: 'YolynPlugin', version: '1.0.0' }

Sync Now

3.7 clean一下Project,然后make Project,在Terminal中输入:gradle moduleyolynplugin。

D:\DevelopSoftWare_Location\Android_Studio\DemoWorkSpace\DefinedGradleDemo1>gradle moduleyolynplugin> Configure project :app welcome to YolynPluginWelcome To OtherPluginthis is module yolynpluginBUILD SUCCESSFUL in 8s。

三个插件都成功运行