Android Gradle 插件自定义Plugin实现注意事项


Posted in Java/Android onJune 16, 2022

Android Gradle Plugin

在 Android 项目中的 build.gradle 文件中,经常可以看见一些 plugin 声明:

plugins {
    id 'com.android.application'
	  id 'com.android.library'
}
// or
apply plugin: 'com.android.application'
apply plugin: 'com.android.library'

上面是两种引用 gradle 插件的常用代码,com.android.application 是用来构建 apk 的 gradle 插件;com.android.library 是用来构建 Android Library 的 gradle 插件。

Gradle 是什么?

Gradle 是自动化构建工具,多项目构建而设计的。通过 groovy 或 kotlin 来编写构建脚本。主要用来处理:

  • 自动处理包依赖关系
  • 自动处理部署问题

过去 Java 开发者常用 Maven 和 Ant 等工具进行封装布署的自动化,或是两者兼用,不过这两个包彼此有优缺点:

  • 如果频繁改变相依包版本,使用 Ant 相当麻烦,
  • 如果琐碎工作很多,Maven 功能不足
  • 而且两者都使用 XML 描述,相当不利于设计 if、switch 等判断式,即使写了可读性也不佳

而 Gradle 改良了过去 Maven、Ant 带给开发者的问题,至今也成为 Android Studio 内置的封装布署工具。

官方文档:What is Gradle?

Gradle 插件

Gradle 的核心是提供自动化处理流程。所有有用的特性,比如编译 Java 代码的能力,都是由插件添加的。

插件实际的作用有:

  • 拓展 Gradle Model (例如:添加可配置的新 DSL 元素)
  • 根据约定配置项目(例如:添加新的 Gradle Task 或配置一些合理的默认值)
  • 应用指定的配置(例如:添加一些仓库或执行标准)

好处:

通过应用插件,而不是向项目构建脚本添加逻辑,可以获得的好处有:

  • 提高复用能力,减少跨多个项目维护类似逻辑的开销:同一个插件可以应用到不同的项目。
  • 更好的模块化:通过插件的形式,可以使项目架构更加明确更容易理解。
  • 封装重要的逻辑,允许构建脚本尽可能具有声明性。

分类

Gradle 插件有两种类型,分为二进制插件和脚本插件。

二进制插件:

  • 二进制插件可以通过实现 org.gradle.api.Plugin 接口以编程方式编写,也可以使用 Gradle 的一种 DSL 语言以声明方式编写。
  • 二进制插件可以驻留在构建脚本中、项目层次结构中或外部插件 jar 包中。

脚本插件:

  • 脚本插件是额外的构建脚本,可以进一步配置构建并且通常实现一种声明性的方法来操作构建。它们通常在构建中使用,尽管它们也可以外部化并从远程位置访问。
  • 插件通常以脚本插件开始(因为它们易于编写),然后随着代码变得更有价值,它被迁移到可以在多个项目或组织之间轻松测试和共享的二进制插件。

使用插件

要使用插件中封装的构建逻辑,Gradle 需要执行两个步骤。 首先,解析插件,然后需要将插件应用到一个目标上,通常是一个 org.gradle.api.Project 对象。

  • 解析插件:解析插件的工作是找到包含给定插件的正确版本的 jar 并将其添加到脚本类路径中。一旦一个插件被解析,它的 API 就可以在构建脚本中使用。
  • 应用插件:应用插件意味着在要使用插件的项目上实际执行插件的Plugin.apply(T 。应用插件是幂等的。也就是说,您可以安全地多次应用任何插件而不会产生副作用。

本篇文章主要介绍如何实现一个二进制插件。

实现一个插件

最简单的构建 Gradle 插件的方式是 通过命令来构建:

gradle init // or ./gradlew init

执行命令:

Android Gradle 插件自定义Plugin实现注意事项

  • 第一步,选择项目类型,4 是 Gradle 插件项目。
  • 第二步,选择实现芋圆,这里主要是 插件的代码语言,支持 Groovy、Java 和 Kotlin。
  • 第三步,选择 DSL 语言(构建脚本语言),支持 Groovy 和 Kotlin。
  • 第四步,输入项目名称和插件包名。

最后会显示构建结果。 构建完的项目结构是这样的:

Android Gradle 插件自定义Plugin实现注意事项

这里有很多不需要的文件目录,包括用来测试和 Gradle 的一些相关内容,都可以删除(当然你也可以不处理),因为当我们把这个项目引入到一个 Android 项目中时,Android 项目提供了 Gradle 相关文件。

Android Gradle 插件自定义Plugin实现注意事项

如图所示,ExamplePlugin 目录下 gradle 相关的文件,在 Android 的根目录中都存在。 其中构建插件相关的内容都在 build.gradle 文件中,首先是,插件项目引用的插件:

plugins {
    id 'java-gradle-plugin' 
    id 'maven' // maven 仓库
    id 'groovy'	// groovy 支持
}

需要重点注意的是,使用一些第三方依赖如果下载不到,要检查引用的远程仓库是否在包含想要引用的依赖:

repositories {
    // Use JCenter for resolving dependencies.
    jcenter()
}

当我想引用 com.android.tools.build:gradle 依赖时,一直报错,原因是 jcenter 中不存在这个项目,需要添加 google()

然后是一些依赖:

dependencies {
    // ...
    testImplementation 'org.spockframework:spock-core:1.3-groovy-2.5'
}

接下来是比较重要的插件定义:

gradlePlugin {
    // Define the plugin
    plugins {
        customName {
            id = 'com.example.plugin.customname'
            implementationClass = 'com.example.plugin.ComExamplePluginPlugin'
        }
    }
}

这里需要注意的是 customName 是你可以随意定义的字符串,这个字符串会在 Plugin.apply 方法中使用到。 Id 就是插件唯一标识,后续在其他项目中引用的时候,也是引用这个 id 。 implementationClass 的值指向一个实际的代码类,这个类实现了 org.gradle.api.Plugin 。 自动生成的 Plugin 实现类是这样的:

class ComExamplePluginPlugin implements Plugin<Project> {
    void apply(Project project) {
        // Register a task
        project.tasks.register("customName") {
            doLast {
                println("Hello from plugin 'com.example.plugin.customname'")
            }
        }
    }
}

在这个 apply 方法中,使用之前我们定义的 customName 注册了一个 Task 。 实际上 Gradle 后续就是执行这个 Task ,来执行代码块中的代码的。

在很多之前的 Gradle 插件实现方案中,需要创建 resources/META-INF/gradle-plugin/xxx.properties ,而通过上面的方式,不需要在去创建这个文件了。 这样一个插件的定义基本上就完成了。

发布插件

我们已经定义好了一个 Gradle 插件,那么应该如何校验这个插件是否真的能够使用呢?为了解决这个问题,我们要把 Gradle 插件发布到远程仓库或者本地目录,然后供其他项目引用,以此来测试插件。 以本地发布为例,在插件项目的根目录下的 build.gradle 文件中添加:

plugins {
	  // ...
    id 'maven-publish' // 用来发布插件
}
publishing {
    repositories {
        maven {
            // $rootDir 表示你项目的根目录
			  // 这里配置发布到的本地目录
            url = "$rootDir/repo" 
        }
    }
    publications {
        publish(MavenPublication) {
            // 插件的组ID,建议设置为插件的包名
            groupId = 'com.example.plugin.customname'
            // 插件的名字,后续在引用时会用到
            artifactId = 'customName'
            version = '0.0.1'
            // 组件类型
            from components.java
        }
    }
}

如果发布到本地,运行 Gradle 命令:

./gradlew publishPublishPublicationToMavenLocal

则会发布到本地目录 /Users/XXX/.m2/repository/ 中。

./gradlew publishPublishPublicationToMavenRepository

会发布到你在 build.gradle 中,指定的目录 "$rootDir/repo" 中。

Android Gradle 插件自定义Plugin实现注意事项

引用插件

在 Android 项目中引用的第一步是在根目录的 build.gradle中添加 maven 仓库,这样 Gradle 才能从特定的本地目录中找到我们的 jar 包:

repositories {
    jcenter()
    google()
    maven {
        url = "$rootDir/repo"
    }
}

第二步,在根目录的 build.gradle 中添加依赖:

dependencies {
    classpath "com.example.plugin.customname:customName:0.0.1"
}

这个就是我们在发布插件时,指定的 groupId 、artifactId 和 version,规则是:

classpath "$groupId:$artifactId:$version"

然后,在需要引用的 module 下的 build.gradle 文件中应用插件:

plugins {
    id 'com.example.plugin.customname'
}

这里的 id 是我们在定义插件时在 gradlePlugin 代码块中指定的。 这样我们就成功的通过 jar 包的形式引用到了插件。 这里以我另一个项目为例,我在 gradlePlugin 中指定的代码块自定义名称为 transfrom :

gradlePlugin {
    plugins {
        transform {
			 // ...
        }
    }
}

引用成功后会在 Gradle Task 中多一个同名的任务:

Android Gradle 插件自定义Plugin实现注意事项

对应的 Groovy 中实现 apply 方法:

@Override
void apply(Project project) {
    project.tasks.register("transform") {
        doLast {
            println("Hello from plugin 'com.chunyu.transform.plugin'")
        }
    }
}

执行该任务,会看到 log 面板中有对应的输出:

> Task :app:transform
Hello from plugin 'com.chunyu.transform.plugin'

成功的验证了,在 apply 中 print 代码正确的执行了。

到此这篇关于Android Gradle 插件自定义Plugin实现注意事项的文章就介绍到这了,更多相关Android Gradle 插件内容请搜索三水点靠木以前的文章或继续浏览下面的相关文章希望大家以后多多支持三水点靠木!


Tags in this post...

Java/Android 相关文章推荐
手把手教你用SpringBoot将文件打包成zip存放或导出
Jun 11 Java/Android
浅谈什么是SpringBoot异常处理自动配置的原理
Jun 21 Java/Android
详解Spring Boot使用系统参数表提升系统的灵活性
Jun 30 Java/Android
Java Socket实现多人聊天系统
Jul 15 Java/Android
Spring中的使用@Async异步调用方法
Nov 01 Java/Android
SpringDataJPA在Entity中常用的注解介绍
Dec 06 Java/Android
springboot layui hutool Excel导入的实现
Mar 31 Java/Android
Android开发之WECHAT微信小程序路由跳转的两种形式
Apr 12 Java/Android
springboot实现string转json json里面带数组
Jun 16 Java/Android
Java界面编程实现界面跳转
Jun 16 Java/Android
Spring boot admin 服务监控利器详解
Aug 05 Java/Android
Java完整实现记事本代码
Jun 16 #Java/Android
Springboot中如何自动转JSON输出
Jun 16 #Java/Android
springboot为异步任务规划自定义线程池的实现
详解Flutter自定义应用程序内键盘的实现方法
ConditionalOnProperty配置swagger不生效问题及解决
Jun 14 #Java/Android
Java异常体系非正常停止和分类
Android开发手册TextInputLayout样式使用示例
Jun 10 #Java/Android
You might like
PHP4之真OO
2006/10/09 PHP
php处理restful请求的路由类分享
2014/02/27 PHP
jquery+php+ajax显示上传进度的多图片上传并生成缩略图代码
2014/10/15 PHP
一个比较不错的PHP日历类分享
2014/11/18 PHP
php常用字符串处理函数实例分析
2014/11/22 PHP
JS input 数字验证代码
2009/07/30 Javascript
js 多种变量定义(对象直接量,数组直接量和函数直接量)
2010/05/24 Javascript
学习JavaScript的最佳方法分享
2011/10/21 Javascript
学习从实践开始之jQuery插件开发 对话框插件开发
2012/04/26 Javascript
JS+CSS实现一个气泡提示框
2013/08/18 Javascript
实现51Map地图接口(示例代码)
2013/11/22 Javascript
JavaScript事件类型中UI事件详解
2016/01/14 Javascript
JS判断图片是否加载完成方法汇总(最新版)
2016/05/13 Javascript
JQuery遍历元素的后代和同胞实现方法
2016/09/18 Javascript
原生js和css实现图片轮播效果
2017/02/07 Javascript
利用jquery去掉时光轴头尾部线条的方法实例
2017/06/16 jQuery
深入理解Vue transition源码分析
2017/07/30 Javascript
在Debian(Raspberry Pi)树莓派上安装NodeJS的教程详解
2017/09/19 NodeJs
详解一个基于react+webpack的多页面应用配置
2019/01/21 Javascript
微信小程序--特定区域滚动到顶部时固定的方法
2019/04/28 Javascript
vue前端框架—Mint UI详解(更适用于移动端)
2019/04/30 Javascript
[04:29]2014DOTA2国际邀请赛 主赛事第三日TOPPLAY
2014/07/21 DOTA
python完成FizzBuzzWhizz问题(拉勾网面试题)示例
2014/05/05 Python
Python中操作MySQL入门实例
2015/02/08 Python
Python定时执行之Timer用法示例
2015/05/27 Python
实例讲解Python中函数的调用与定义
2016/03/14 Python
python bmp转换为jpg 并删除原图的方法
2018/10/25 Python
python3对拉勾数据进行可视化分析的方法详解
2019/04/03 Python
命令行运行Python脚本时传入参数的三种方式详解
2019/10/11 Python
C++面试题目
2013/06/25 面试题
New delete 与malloc free 的联系与区别
2013/02/04 面试题
优秀中专生推荐信
2013/11/17 职场文书
上课迟到检讨书
2014/02/19 职场文书
土建施工员岗位职责
2014/07/16 职场文书
计划生育证明书写要求
2014/09/17 职场文书
小学校长个人总结
2015/03/03 职场文书