阅读 239

Gradle 自定义 plugin

学习完毕 Gradle 的基础知识,不来点实战,感觉就像没有学习过啊。那我们就搞一搞实战,一共两个简单的操作。第一,写一个自定义 Plugin。第二,写一个自定义 Transform。

自定义 Plugin

网上一般都会说三种方法是去创建,咱们就不来那么多虚的,来个一劳永逸的吧,我们直接新建一个工程来写,这个会了,新建 Library 工程 和在 build.gradle 中的这两种方式相信你也就会了。

一、创建 Groovy 项目

注意:我用的是 IntelliJ IDEA,这个就和 Android 没有关系了。

选择 Gradle 项目,勾选中 Groovy。

groupId、artifactId、version 三者确定唯一库。

groupId:是项目组织唯一的标识符,实际对应JAVA的包的结构,是main目录里java的目录结构。

artifactId:是项目的唯一的标识,实际对应项目的名称,就是项目根目录的名称。

version:指的是版本号,注意:SNAPSHOT意为快照,说明该项目还处于开发中,是不稳定的版本。

最后点,点,点,finish。就ok了。

二、配置 build.gradle

因为我们这个是 Gradle 项目,我们要配置一下一些第三方依赖。

plugins {
    id 'groovy'
    id 'maven'
}

group 'com.ssy.plugins'
version '1.0.0'

repositories {
    mavenCentral()
    google()
    jcenter()
}

dependencies {
    //Gradle Plugin 依赖
    implementation gradleApi()
    //本地发布 Plugin
    implementation localGroovy()
    //因为我们需要在android 项目中使用,所以需要android的tool build库
    implementation 'com.android.tools.build:gradle:3.3.2'
}
复制代码

三、开始自定义 plugin

首先需要说明的是一个概念,就是比如我们平时使用的 apply plugin: 'com.android.application'这个 plugin的名字是需要我们进行配置的。

1、创建 plugin id

在 resources 文件夹下,新建一个 META-INF 文件夹,在 META-INF 里新建 gradle-plugins 文件夹,最后创建我们的 pluginName.properties,注意后缀哈。 比如我写的就是com.ssy.plugins.ssyplugin.properties。我的 plugin id 就是com.ssy.plugins.ssyplugin。最后在这个文件中写下我们自定义 plugin的路径。

2、创建自定义 plugin 文件

创建 SsyPlugin.groovy 文件,注意:我们是在groovy中写的,不是java。

package com.ssy.plugins

import org.gradle.api.Plugin
import org.gradle.api.Project
import com.android.build.gradle.AppExtension

class SsyPlugin implements Plugin<Project> {
    @Override
    void apply(Project project) {

        project.task("hello"){
            println('hellow~~~~~~~')
        }
    }
}
复制代码

到此我们自定义的 plugin 就算是基本完成,简单吧,然后我们就要发布我们的 plugin。

3、发布 plugin

在 build.gradle 文件中添加下面的代码

uploadArchives {
    repositories {
        mavenDeployer {
            //设置插件的GAV参数
            pom.groupId = 'com.ssy.plugins'
            pom.version = '1.0.0'
            //文件发布到下面目录
            repository(url: uri('../repo'))
        }
    }
}
复制代码

点击右边 Gradle 中的uploadArchives,就可以生成我们jar包了。 当然我们也可以在 Terminal 中运行 ./gradlew uploadArchives 一个意思。

补充小知识:../repo,就是当前project 目录的外层目录。

1、./是当前目录

2、../是父级目录

3、/是根目录

最后你就可以找到 SsyPlugin-1.0.0.jar 了。

结束。手工~~

呸,还没说怎么用收你妹的工啊,额,好好,写完回家,回~~家。

四、Android 项目使用自定义 plugin

我们新建一个 Android 项目,这个就不演示了。 首先,我们需要把 repo 项目,从复制到,我们android 项目的 父目录,也就是和我们这个项目平级。这样我们就可以使用它了。

首先我们需要在 项目的 gradle.build 中,不是 app 的 gradle.build,如图吧,这样明白一点。

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {

    repositories {
    //配置我们仓库地址
        maven {
            url uri('../repo')
        }
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.2.1'
        //这个就是 仓库中指定我们需要的版本 
        classpath 'com.ssy.plugins:SsyPlugin:1.0.1'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        maven {
            url uri('../repo')
        }
        google()
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

复制代码

小知识:classpath 是用来配置 buildscript 的。

好配置完 project 的 gradle.build ,我们来配置 app 的 gradle.build。 直接使用就好了。

apply plugin:'com.ssy.plugins.ssyplugin'
复制代码

好了,配置完毕。 我们来检验一下我们是否搞成功了。 命令行敲起来 ./gradlew hello。

ok ,完工,下一篇 自定义 Transform。

关注下面的标签,发现更多相似文章
评论