Gradle基础 | 自定义插件并上传到JitPack

最是人间留不住，朱颜辞镜花辞树。这篇文章主要讲述Gradle基础 | 自定义插件并上传到JitPack相关的知识，希望能为你提供帮助。

本篇文章已授权微信公众号 guolin_blog (郭霖)独家发布

Hi ???????? ，很高兴见到你！
这是我的2022技术进阶计划，Gradle系列的第二篇，希望对你有所帮助。
引言每一个使用 ??Gradle?? 的同学，肯定都听过或者写过插件，因为其本身并不难，但碍于现在网上的文章千篇一律，大部分都比较老，新同学一上手反而是和我一样，花了大把时间在最基础的第一步如何写一个简单demo上。再者如果大家使用 ?AndroidStudio BumBlebee? 去创建项目，那对照网上教程差别更大，甚是花费时间，而本篇就是帮你省掉这些时间。
本篇主要概括创建插件的三种方式，并如何上传到 ??JitPack?? 中。

开发环境基于最新的?Gradle7.0.4?,?AndroidStudio BumBlebee；
本文相关示例代码,??github??

什么是插件？在 ??Gradle?? 中，插件相当于打包了可重用的一些构建片段，使其可复用为多个项目去构建。如下所示：

// 新版写法
plugins
id com.android.application

// 旧版写法
apply plugin: com.android.library

上述就是我们最常见的两个插件，比如当我们在创建一个 android-model 时，就会自动添加相应的 ??library?? 插件，这些插件的工作就是帮我们把一些重复的工作或者代码，以一句代码的形式引入，极大程度上减少了我们的代码量。
在 ??Gradle?? 中，我们可以使用 ??java?? ，??Kotlin?? 以及 ??Groovy?? 来写自己的插件，一般而言，使用 ??Java?? 和 ??Koltin?? 要比使用 ??Groovy?? 的执行效果会更好。题外话: 写法上，??Java?? 与 ??kotlin?? 也更符合开发习惯。
插件的用途有哪些？插件的作用就是添加我们自己的一些逻辑到项目执行过程中，这个做法在 ??Gradle?? 中称其为任务，或者说 ??Task?? ，从而对项目进行测试、编译、打包等;
也可以对项目中现有的对象类型添加新的扩展属性、方法等、也可以配置和优化项目的构建，比如常见的 ??android?? 就是 ??Android Gradle?? 插件为 ??Project?? 对象添加的一个扩展。
日常开发中，我们还有很多插件会在开发中见到，比如 ??didibooster?? 的插件，阿里路由插件，一些第三方的打点插件等。
有一个比较有意思的问题，我觉得你可能会有？

??这些插件一般还要在model中再依赖其他组件，如果我只用代码组件，而不启用这些插件，那还能正常使用吗？??
其实一般情况下，不影响你在开发中正常使用，一个??合格??的三方库，在插件没启用时也不会影响最终的使用效果，无非就是最终的实现方式上会有所差别，比如性能上。类似阿里路由插件，如果不启用插件，只依赖代码组件依赖，则在最终找路由表时就只能通过反射去找，而不是通过编译期间生成的路径映射，所以一般我们在debug下可以关闭某些依赖，从而减少debug时间，不过一般而言，这些插件所花费的时间并不多，所以根据自身需求而定。

创建插件方式脚本插件
我们可以直接在构建脚本中包含插件的源代码，这种是最简单易懂的一种方式，具体示例如下：

直接在 app model 中写插件，这样做的好处就是插件会自动编译并包含在构建脚本的类路径中，而无需做其他操作。相应的，如果要跨项目复用，就比较难解决，而且因为缺少统一的维护路径，也增加了后期成本。
buildSrc
官方建议我们可以将本地插件的代码放到 ??buildSrc?? 这个目录中。这个目录比较特殊，对于每一个工程而言，有且只能有一个 ??buildSrc?? 目录，并且必须位于项目的根目录，如果存在 ??buildSrc?? 这个目录，那么 ??Gradle?? 在运行时会自动编译并测试这里面的代码，并将其放入构建脚本的类路径中，与上述的脚本插件相比，其更易于维护和管理测试。

示例代码：??buildSrc??

使用教程:
我们新建一个名为 ??buildSrc?? 的目录，然后直接创建一个 build.gradle 文件，如下所示:

代码如下：

apply plugin: kotlin
buildscript
repositories
google()
mavenCentral()

dependencies
// 因为想使用kotlin，所以这里增加kotlin插件
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.6.10-RC"

repositories
google()
mavenCentral()

dependencies
implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.6.10"

接着 ??sync?? 一下，然后你就会发现，这个 buildSrc 已经被 Android Studio 自动识别为了一个 java 项目。如下：

当然你也可以直接创建一个 ??java-model??,然后去更改 ??build?? 文件,这样的好处是省去了手动创建文件夹的功夫，相应的，你也需要去??settings.gradle?? 去删除这个model的声明，原因是：buildSrc是一个特殊的目录，禁止手动声明；

到了这里，那我们如何创建自己的插件文件呢，直接在 ??src?? 下创建相应的文件夹即可，然后创建我们自己的插件文件，如下所示：

【Gradle基础 | 自定义插件并上传到JitPack】上面的这个目录格式，根据你自己的写法而定，比如这里我想使用 ??kotlin?? 去写插件代码，就使用如下，默认官方推荐了三种目录配置写法：

src/main/kotlin
src/main/java
src/main/groovy

ps：当使用As在buildSrc创建目录时，会自动提示选择合适的目录。

上述我们创建了自定义的插件实现类，现在就去改一下我们的 ??build.gradle?? 文件，增加下述代码：

//java-gradle插件
apply plugin: java-gradle-plugin
...

//本地依赖插件时使用
gradlePlugin
plugins
//插件名,每一个插件都可以有
buildSrcTestPlugin
// 你的插件id，外部项目引用时需要
id = com.petterp.gradle.buildSrc
// 插件的具体实现类
implementationClass = com.petterp.gradle.BuildSrcGradlePlugin

//第二个插件
//test2Plugin
//id = xxx
//implementationClass = xxx
//

改完之后，然后在我们的app-build.gradle(具体取决于你的使用位置)中进行依赖引入即可：

到这里就结束了，是不是超简单，如果你搜过老的教程，你会发现你需要手动创建resource即META-xxx等等。
其实并不是我们没有创建，而是我们使用的 ??java-gradle-plugin?? 插件会自动创建，并且以 ??api?? 的方式引入 gradleApi() ,会自动帮我们将上述的步骤实现。具体最终生成在这里，如下图所示：

Standalone project
上面的两种方式只能在当前项目中进行使用，如果我们想要在其他项目中使用，此时一般我们会将插件发布到 ??Maven?? 上，与其他人进行共享，这也是开发插件最常用的一种方式了,本篇会上传到 ??JitPack?? 上。

示例代码：standlone

我们复制粘贴上面教程里的 buildSrc 包，并对其进行改名如下，比如改为 ??stand-gradle-plugin?? ,然后在我们的项目 ??settings.build?? 中引入此model，如下所示：

看着好像过于简单了点，也没啥不同，你可能会想，那这样的话，那 ??buildSrc?? 的用处是啥？反正似乎啥名字都可以啊？
我们先改一下 stand-gradle-plugin 的 ??插件id?? ，及相应的 ??插件实现类类名?? ，如下所示：

然后直接去app-model中进行引入，此时会发生什么问题呢？

提示找不到这个插件，为什么？我不是在 ??settings.gradle?? 中引入了吗？
我们在最上面说过了，??buildSrc?? 本身是一个特殊的项目，Gradle 会自动编译并引入。而其他插件，如果没有采用 ??maven?? 的方式引入，就需要单独配置了，如下所示：
我们更改一下 ??settings.gradle?? 文件：

includeBuild(stand-gradle-plugin)

更改 ??项目根build.gradle??:

plugins
...
id com.petterp.gradle.stand apply false

重新sync就不会报错了，结果如下图所示：

这其实就相当于我们使用了本地的一个插件，如果你使用过复合构建去配置过你的项目依赖配置，可能对这种方式就非常熟悉了。
上传到JitPack中一般而言，我们会将插件上传到 ??Maven?? 上，便于跨项目使用。我们以 ??Standalone Project?? 这种方式为例，更改 Standalone 方式中的??build.gradle??，如下所示,增加下列代码：

示例代码：??stabdlobe-build.gradle??

apply plugin: maven-publish

// 组名，可以理解为插件在那个分组下放着，最终是一个文件夹
// com/petterp/gradle/plugins/xxx
group = com.petterp.gradle
// 描述
description = 这是一个独立插件
// 版本号
version = 1.0.0

sourceCompatibility = JavaVersion.VERSION_11
publishing
publications
maven(MavenPublication)
// 版本id，最终会根据这个id-version生成相应的插件
artifactId = com.petterp.gradle.plugin
from components.java

repositories
maven
// 生成的插件位置
url = uri(../repo)

更改settings.gradle中插件依赖的方式为

include :stand-gradle-plugin

然后在命令行执行：??gradlew publish??
此时我们的项目里就会多出一个 ??repo?? 的文件夹，如下图所示，这就是我们最终打包好的插件包。

接下来去 github 打 Tag,并打开 ??Jitpack?? 网站，搜索我们的项目名称，进行构建。

完成后我们就可以在项目中进行引用了，如下图所示：

因为我们生成的是插件，所以相应的依赖方式改为 ??classpath??