Android Gradle 开发与应用 (五) : 基于Gradle 8.2，创建Gradle插件

左手的ㄟ右手 2024-04-25 20:26 115阅读 0赞

### 1. 前言 ###

本文介绍在`Android`中，如何基于`Gradle 8.2`，创建`Gradle`插件。

#### 1.1 本文环境 ####

*  `Android Studio` 版本 : `Android Studio Hedgehog | 2023.1.1`
 *  `Gralde`版本 : `gradle 8.2`

> [使用 Android Gradle 插件升级助理][Android Gradle]  
> [Android Gradle 插件版本说明][Android Gradle 1]

#### 1.2 为什么要写插件 ####

可以将相关代码抽取出来，而不是耦合在`build.gradle`中，成为通用性的插件，可以在多个项目中复用。  
比如`com.android.application`就是我们最为熟悉的`Android`插件。

plugins {
        
        id 'com.android.application'
    }

### 2. 创建插件 ###

#### 2.1 新建项目 ####

新建`MyGradlePluginTest`项目，这里选择`Groovy DSL`。

![在这里插入图片描述][f3ac418943434343a030dd163fab250a.png]

#### 2.2 新建Gradle插件Module ####

这里选择`Java or Kotlin Library`，也可以选择`Android Library`  
![在这里插入图片描述][249d27adcf4848e5ad523f198179fc0d.png]

#### 2.3 修改build.gradle ####

plugins {
        
        id 'java-gradle-plugin'
    }
    
    gradlePlugin {
        
        plugins {
        
            //MyTestPlugin { //这种方式也行
            create("MyTestPlugin") {
        
                //插件id
                id = 'com.heiko.myplugin'
                //插件的包名+类名
                implementationClass = 'com.heiko.myplugin.MyPlugin'
            }
        }
    }

#### 2.4 新建插件类 ####

对应`implementationClass`中的路径，新建插件类 `MyPlugin`

package com.heiko.myplugin;
    
    import org.gradle.api.Plugin;
    import org.gradle.api.Project;
    
    class MyPlugin implements Plugin<Project> {
        
    
        @Override
        public void apply(Project project) {
        
            System.out.println("这是我的第一个插件!");
        }
    }

### 3. 发布插件 ###

#### 3.1 依赖maven-publish ####

在`build.gradle`中，添加`maven-publish`插件，然后配置发布插件的信息和仓库信息。  
这里的`maven`仓库配置的是本地的，仅用作演示。实际项目中，应该使用真实的`maven`仓库服务器更合理些。  
关于`maven`仓库更多的操作，详见我的另一篇文章 : [Android Module上传到Maven仓库 及 实现同时上传到多个Maven仓库][Android Module_Maven_ _ _Maven]

plugins {
        
     	//...省略了代码...
        id 'maven-publish'
    }
    
    //...省略了代码...
    
    println("原本的version:" + version)
    println("原本的group:" + group)
    
    //设置group
    group = 'com.heiko.group'
    //设置版本号
    version = "1.0.0"
    
    println("设置后的group:" + group)
    println("设置后的version:" + version)
    
    afterEvaluate {
        
        /*
        这部分代码不需要配置，会根据gradlePlugin中的进行生成
        除非使用老版本的插件依赖方式(classpath):需要指定artifactId的情况下，才需要使用
        publications {
            maven(MavenPublication) {
                groupId = group
                artifactId = 'MyPlugin'
                version = version
    
                from components.java
            }
        }*/
        publishing {
        
            // 配置仓库地址
            repositories {
        
                maven {
        
                    url = uri('../repo')
                }
            }
        }
    }

`build.gradle`的完整代码如下

plugins {
        
        id 'java-gradle-plugin'
        id 'maven-publish'
    }
    
    gradlePlugin {
        
        plugins {
        
            //MyTestPlugin { //这种方式也行
            create("MyTestPlugin") {
        
                //插件id
                id = 'com.heiko.plugin.myplugin'
                //插件的包名+类名
                implementationClass = 'com.heiko.myplugin.MyPlugin'
            }
        }
    }
    
    println("原本的version:" + version)
    println("原本的group:" + group)
    
    //设置group
    group = 'com.heiko.group'
    //设置版本号
    version = "1.0.0"
    
    println("设置后的group:" + group)
    println("设置后的version:" + version)
    
    afterEvaluate {
        
        /*
        这部分代码不需要配置，会根据gradlePlugin中的进行生成
        除非使用老版本的插件依赖方式(classpath):需要指定artifactId的情况下，才需要使用
        publications {
            maven(MavenPublication) {
                groupId = group
                artifactId = 'MyPlugin'
                version = version
    
                from components.java
            }
        }*/
        publishing {
        
            // 配置仓库地址
            repositories {
        
                maven {
        
                    url = uri('../repo')
                }
            }
        }
    }

#### 发布插件 ####

这个时候，点击下`Sync`同步下代码，然后可以在右侧`Gradle`的`Tab`中，找到`publishing`，里面有`publish`选项，我们双击它，就开始执行发布插件的操作了。

![在这里插入图片描述][724c728dc6e54899a88e30cb8356aaab.png]  
上传插件成功后，可以看到如下信息  
![在这里插入图片描述][7128816208f24fd08bff86fe98cbc64b.png]

### 4. 使用插件 ###

#### 4.1 添加Maven仓库 ####

pluginManagement {
        
        repositories {
        
        	//省略了其他仓库...
            maven {
        
                url 'repo'
            }
        }
    }

#### 4.2 依赖插件 ####

在更目录下的`build.gradle`中，依赖插件

plugins {
        
        id 'com.android.application' version '8.2.0' apply false
        //省略了其他插件代码
    	id 'com.heiko.plugin.myplugin' version '1.0.0' apply false
    }

> 通常默认配置会 立马 解析（resolve） 并 应用（apply） 插件。  
> 而 apply 设为 false, 表示 不应用插件到 根项目。目的是 提前解析 插件，保持一样的版本。

#### 4.3 应用插件 ####

在`app`目录下的`build.gradle`中，应用插件

plugins {
        
        id 'com.android.application'
        id 'org.jetbrains.kotlin.android'
        //应用插件
        id 'com.heiko.plugin.myplugin'
    }

#### 4.4 同步项目 ####

点击`Sync`同步下项目，可以看到我们的插件打印的日志了

![在这里插入图片描述][8c7badc48ed14b0c9aafaef2e121d163.png]

### 5. 使用Groovy编写插件 ###

上文中我们是使用`java`语言来编写的插件，那么如果使用`Groovy`语言来编写插件，需要怎么操作呢 ?

#### 5.1 添加groovy插件 ####

为了识别`groovy`语言，我们需要在`MyPlugin`目录下的`build.gradle`中添加`groovy`插件

plugins {
        
        id 'java-gradle-plugin'
        //添加groovy插件
        id 'groovy'
        id 'maven-publish'
    }

#### 5.2 新建groovy目录 ####

在和`java`同级别的目录下，新建`groovy`目录，`groovy`目录下需要和原`java`目录一样  
![在这里插入图片描述][257712117c0e4213b6966938712a6893.png]

#### 5.3 新建MyPluginGroovy.groovy ####

在`groovy`目录下，要把`MyPlugin.java`改为`MyPlugin.groovy` ，这里我为了方便区分，把名称改为了`MyPluginGroovy.groovy` 。

package com.heiko.myplugin;
    
    import org.gradle.api.Plugin;
    import org.gradle.api.Project;
    
    class MyPluginGroovy implements Plugin<Project> {
        
    
        @Override
        public void apply(Project project) {
        
            println "这是我的第一个Groovy插件!"
        }
    }

#### 5.4 修改implementationClass ####

修改`MyPlugin`目录下的`build.gradle`文件中的`implementationClass` ，修改为`groovy`目录下对应的插件类的`包名+类名`，注意没有文件后缀。

implementationClass = 'com.heiko.myplugin.MyPluginGroovy'

完整的`build.gradle`文件

plugins {
        
        id 'java-gradle-plugin'
        id 'groovy'
        id 'maven-publish'
    }
    
    gradlePlugin {
        
        plugins {
        
            create("MyTestPlugin") {
        
                //插件id
                id = 'com.heiko.plugin.myplugin'
                //插件的包名+类名
                implementationClass = 'com.heiko.myplugin.MyPluginGroovy'
            }
        }
    }
    
    //设置group
    group = 'com.heiko.group'
    //设置版本号
    version = "1.0.1"
    
    afterEvaluate {
        
        publishing {
        
            // 配置仓库地址
            repositories {
        
                maven {
        
                    url = uri('../repo')
                }
            }
        }
    }

#### 5.5 重新发布插件 ####

将版本号`version`改为`1.0.1`，双击`publish`，重新发布插件

#### 5.6 依赖插件 ####

修改项目根目录下的`build.gradle`，将我们的`com.heiko.plugin.myplugin`插件版本号修改为`1.0.1`。  
重新运行项目，可以看到打印的插件日志变成了

这是我的第一个Groovy插件!

### 6. 使用Kotlin编写插件 ###

除了使用`Java`或`Groovy`编写插件，我们还可以使用`Kotlin`来编写插件，使用`kotlin`对于`Android`开发者来说会更友好。

#### 6.1 添加java插件 ####

为了识别`kotlin`语言，我们需要在`MyPlugin`目录下的`build.gradle`中添加`kotlin`插件

plugins {
        
        id 'java-gradle-plugin'
        //添加Kotlin插件
        id "org.jetbrains.kotlin.jvm"
        id 'maven-publish'
    }

#### 6.2 新建kotlin目录 ####

在和`java`同级别的目录下，新建`kotlin`目录，`kotlin`目录下需要和原`java`目录一样

![在这里插入图片描述][1adeb38b4245420cbebe27994444ca84.png]

#### 6.3 新建MyPluginKotlin.kt ####

在`kotlin`目录下，要把`MyPlugin.java`改为`MyPlugin.kt` ，这里我为了方便区分，把名称改为了`MyPluginKotlin.groovy` 。

package com.heiko.myplugin
    
    import org.gradle.api.Plugin
    import org.gradle.api.Project
    
    
    class MyPluginKotlin : Plugin<Project> {
        
    
        override fun apply(project: Project) {
        
            println("这是我的第一个Kotlin插件!")
        }
    }

#### 6.4 修改implementationClass ####

修改`MyPlugin`目录下的`build.gradle`文件中的`implementationClass` ，修改为`groovy`目录下对应的插件类的`包名+类名`，注意没有文件后缀。

implementationClass = 'com.heiko.myplugin.MyPluginKotlin'

完整的`build.gradle`文件

plugins {
        
        id 'java-gradle-plugin'
        id "org.jetbrains.kotlin.jvm"
        id 'maven-publish'
    }
    
    gradlePlugin {
        
        plugins {
        
            create("MyTestPlugin") {
        
                //插件id
                id = 'com.heiko.plugin.myplugin'
                //插件的包名+类名
                implementationClass = 'com.heiko.myplugin.MyPluginKotlin'
            }
        }
    }
    
    //设置group
    group = 'com.heiko.group'
    //设置版本号
    version = "1.0.2"
    
    afterEvaluate {
        
        publishing {
        
            // 配置仓库地址
            repositories {
        
                maven {
        
                    url = uri('../repo')
                }
            }
        }
    }

#### 6.5 重新发布插件 ####

将版本号`version`改为`1.0.2`，双击`publish`，重新发布插件

#### 6.6 依赖插件 ####

修改项目根目录下的`build.gradle`，将我们的`com.heiko.plugin.myplugin`插件版本号修改为`1.0.2`。  
重新运行项目，可以看到打印的插件日志变成了

这是我的第一个Kotlin插件!

### 7. 补充 : Gradle 插件中的一些知识 ###

#### 7.1 Gradle Plugin中，Property和String的区别 ####

在Gradle Plugin中，`Property<String>`和`String`之间的主要区别在于它们的动态性和可配置性。

*  **String**：
    
     *  `String`是Java中的一个基本数据类型，用于表示文本或字符序列。
     *  在Gradle脚本或插件中，当你直接使用一个`String`时，它通常是一个静态的、不可变的值。
     *  一旦为`String`变量赋值，除非你重新为其赋值，否则它的值不会改变。
 *  **Property**：
    
     *  `Property<String>`是Gradle提供的一个更高级的类型，用于表示一个可配置的属性，其值类型为`String`。
     *  它是Gradle的模型（Model）系统的一部分，允许你在构建配置过程中动态地设置和查询属性的值。
     *  `Property<String>`提供了更多的灵活性，因为它允许你在构建的不同阶段改变属性的值，甚至可以基于其他任务的输出或用户的输入来设置值。
     *  使用`Property<String>`而不是直接的`String`可以使你的构建脚本或插件更加灵活和可配置。

#### 7.1.1 示例 ####

假设你正在开发一个Gradle插件，该插件需要一个字符串属性来配置某个任务的行为。

如果你使用`String`：

public class MyPluginExtension {
        
        private String myProperty;
        
        public String getMyProperty() {
        
            return myProperty;
        }
        
        public void setMyProperty(String myProperty) {
        
            this.myProperty = myProperty;
        }
    }

在这个例子中，`myProperty`是一个静态的`String`，一旦设置，除非显式地重新设置，否则它的值不会改变。

但是，如果你使用`Property<String>`：

import org.gradle.api.model.Property;
    import org.gradle.api.provider.Provider;
    
    public class MyPluginExtension {
        
        private final Property<String> myProperty;
        
        public MyPluginExtension(ObjectFactory objectFactory) {
        
            this.myProperty = objectFactory.property(String.class);
        }
        
        public Property<String> getMyProperty() {
        
            return myProperty;
        }
        
        // 你还可以提供其他方法来设置或查询属性的值，例如使用set方法或提供一个配置器（configurer）
    }

在这个例子中，`myProperty`是一个`Property<String>`，它允许你在构建的不同阶段动态地设置和查询其值。你可以基于其他任务的输出、环境变量或用户的输入来设置这个属性的值。

总的来说，选择使用`Property<String>`还是`String`取决于你的具体需求和你希望为你的构建脚本或插件提供的灵活性和可配置性程度。

#### 7.2 Gradle中，Property 对象能够响应值的变化，并且与Gradle的构建生命周期、任务依赖关系、缓存策略紧密集成。那么Property有哪些方法 ? ####

Gradle 中的 Property 对象是 Gradle 类型安全构建模型的核心组成部分，它代表了一个可以存储和操作值的容器。一个典型的 Property 对象可能提供以下方法（部分）：

设置和获取值：

*  T get()：获取当前存储在 Property 中的值。
 *  void set(T value) 或者 void setValue(T value)：设置 Property 的新值。  
    可观察性：
 *  addListener(PropertyChangeListener listener)：添加一个监听器，当 Property 值发生改变时会触发通知。
 *  removeListener(PropertyChangeListener listener)：移除已添加的监听器。

验证和转换：

*  void convention(Action<? super T> action)：定义一个“约定”动作，在属性未显式赋值时执行。
 *  void finalizeValueOnRead()：确保在读取属性值时进行最终计算或验证。
 *  void validate(Closure clousre) 或 void validate(ValidationAction action)：为 Property 添加验证逻辑。

懒加载支持：

*  Provider asProvider()：返回一个 Provider 对象，它可以延迟计算 Property 的值直到真正需要时。

### 8. Android Gradle系列文章 ###

[Android Gradle 开发与应用 (一) : Gradle基础-氦客-CSDN博客][Android Gradle _ _ _ Gradle_-_-CSDN]  
[Android Gradle开发与应用 (二) : Groovy基础语法-CSDN博客][Android Gradle_ _ _ Groovy_-CSDN]  
[Android Gradle开发与应用 (三) : Groovy语法概念与闭包-CSDN博客][Android Gradle_ _ _ Groovy_-CSDN 1]  
[Android Gradle开发与应用 (四) : Gradle构建与生命周期-CSDN博客][Android Gradle_ _ _ Gradle_-CSDN]  
[Android Gradle开发与应用 (五): 基于Gradle 8.2，创建Gradle插件-CSDN博客][Android Gradle_ _ _Gradle 8.2_Gradle_-CSDN]  
[Android Gradle 开发与应用 (六) : 创建buildSrc插件和使用命令行创建Gradle插件-CSDN博客][Android Gradle _ _ _ _buildSrc_Gradle_-CSDN]

### 9. 参考文章 ###

[Using Plugins (gradle.org)][Using Plugins _gradle.org]  
[Gradle用户手册 - Gradle8.1.1中文文档 - API参考文档 - 全栈行动派 (qzxdp.cn)][Gradle_ - Gradle8.1.1_ - API_ - _ _qzxdp.cn]  
[编写 Gradle 插件 | Android Studio | Android Developers (google.cn)][Gradle _ _ Android Studio _ Android Developers _google.cn]  
[Android Gradle8.0版本新建Gradle插件 - 掘金 (juejin.cn)][Android Gradle8.0_Gradle_ - _ _juejin.cn]  
[Gradle基础到进阶 - yechaoa的专栏 - 掘金 (juejin.cn)][Gradle_ - yechaoa_ - _ _juejin.cn]  
[【Gradle-8】Gradle插件开发指南 - 掘金 (juejin.cn)][Gradle-8_Gradle_ - _ _juejin.cn]  
[【Gradle-9】Gradle插件发布指南 - 掘金 (juejin.cn)][Gradle-9_Gradle_ - _ _juejin.cn]  
[Gradle自定义插件实践与总结 - 掘金 (juejin.cn)][Gradle_ - _ _juejin.cn]  
[创建Gradle插件记录 - 掘金 (juejin.cn)][Gradle_ - _ _juejin.cn 1]

[Android Gradle]: https://developer.android.google.cn/build/agp-upgrade-assistant?hl=zh-cn
[Android Gradle 1]: https://developer.android.google.cn/build/releases/gradle-plugin?buildsystem=ndk-build&hl=zh-cn#updating-gradle
[f3ac418943434343a030dd163fab250a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/25/aadbf95e908d4f9baf01c161b54e2da6.png
[249d27adcf4848e5ad523f198179fc0d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/25/d477b7fcaaf34f0eb8a1cc480736e2c5.png
[Android Module_Maven_ _ _Maven]: https://blog.csdn.net/EthanCo/article/details/124277333
[724c728dc6e54899a88e30cb8356aaab.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/25/dbaa166430c442edafbc0339b5a4f022.png
[7128816208f24fd08bff86fe98cbc64b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/25/12bd02a7a7034da1b532dfd673aae740.png
[8c7badc48ed14b0c9aafaef2e121d163.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/25/fd0e6ec0dbe2464fb75d5e3b2d714c3e.png
[257712117c0e4213b6966938712a6893.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/25/3b79c007be7547a4bb95e35c6a1d629d.png
[1adeb38b4245420cbebe27994444ca84.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/25/86a96caca46f47f9b556046695d8c202.png
[Android Gradle _ _ _ Gradle_-_-CSDN]: https://blog.csdn.net/EthanCo/article/details/136163403
[Android Gradle_ _ _ Groovy_-CSDN]: https://blog.csdn.net/EthanCo/article/details/136171921
[Android Gradle_ _ _ Groovy_-CSDN 1]: https://blog.csdn.net/EthanCo/article/details/136174612
[Android Gradle_ _ _ Gradle_-CSDN]: https://blog.csdn.net/EthanCo/article/details/136182914
[Android Gradle_ _ _Gradle 8.2_Gradle_-CSDN]: https://blog.csdn.net/EthanCo/article/details/135605620
[Android Gradle _ _ _ _buildSrc_Gradle_-CSDN]: https://blog.csdn.net/EthanCo/article/details/136601282
[Using Plugins _gradle.org]: https://docs.gradle.org/current/userguide/plugins.html#sec:plugin_markers
[Gradle_ - Gradle8.1.1_ - API_ - _ _qzxdp.cn]: https://doc.qzxdp.cn/gradle/8.1.1/userguide/userguide.html
[Gradle _ _ Android Studio _ Android Developers _google.cn]: https://developer.android.google.cn/build/extend-agp?hl=zh-cn
[Android Gradle8.0_Gradle_ - _ _juejin.cn]: https://juejin.cn/post/7311562052510072868?searchId=20240115161021D6EF7084E2D01103FFB8
[Gradle_ - yechaoa_ - _ _juejin.cn]: https://juejin.cn/column/7123935861976072199
[Gradle-8_Gradle_ - _ _juejin.cn]: https://juejin.cn/post/7267091810380136508?searchId=20240115161021D6EF7084E2D01103FFB8#heading-6
[Gradle-9_Gradle_ - _ _juejin.cn]: https://juejin.cn/post/7280062870669246525?searchId=20240115161021D6EF7084E2D01103FFB8#heading-13
[Gradle_ - _ _juejin.cn]: https://juejin.cn/post/7292952125193256995?searchId=20240115161021D6EF7084E2D01103FFB8
[Gradle_ - _ _juejin.cn 1]: https://juejin.cn/post/7302712860806610971?searchId=20240115161021D6EF7084E2D01103FFB8