[转载]Gradle 插件 发布到本地和远程仓库

最近在公司 开发gradle插件, 再发布的时候遇到了问题 所以,就转载了这篇文章,和大家分享

Gradle

Gradle 是个的构建工具,也是Android Studio 默认的构建工具,与传统的 Ant 、maven 相比,Gradle 更加强大。利用 Gradle 这个工具,我们能做很多事情,例如热修复、插件化等等。

当然,这篇文章不会将具体的 Gradle 语法,这篇文章只会记录如何创建一个Gradle 插件。

如果你想彻底理解并应用 Gradle ,推荐看这系列文章 Gradle for Android

Gradle 插件是使用 Groovy 语言进行开发的,而 Groovy 是可以兼容 Java 的。Android Studio 除了开发 APP 外,完全可以开发 Gradle 插件。

插件开发

现在来说下,详细的 Gradle 插件开发步骤:

  1. 新建一个项目

  2. 再新建一个 Module,此 Module 用于开发插件,类型选什么都无所谓,后面会大改。

  3. 在 Project 目录视图模式下,清空 build.gradle 文件的内容,删除其余的所有文件。

  4. 然后在 module 中新建多个文件夹 src/main/groovy ,再新建包名文件夹。 在 main 目录下再新建resources 目录,在resources 目录下再新建 META-INF 文件夹,再新建文件夹gradle-plugins,这样就完成了 gradle 插件的目录结构搭建,整个目录结构如下。

image.png
  1. 打开 build.gralde 文件,替换全部内容

    apply plugin: 'groovy'
    apply plugin: 'maven'
    
    dependencies {
       compile gradleApi() //gradle sdk
       compile localGroovy() //groovy sdk
    }
    
    repositories {
       jcenter()
    }
    
  2. 现在,就可以来正式写插件内容了。在刚刚新建的包名下 再次新建一个文件 MyPlugin.groovy,注意文件类型,一定是 groovy 类型文件,刚开始没注意,直到出了问题,排查时,打开本地文件才发现文件没有后缀名称。

    package com.app.plugin
    
    import org.gradle.api.Plugin
    import org.gradle.api.Project
    
    public class MyPlugin implements Plugin<Project> {
    
     void apply(Project project) {
       def log = project.logger
       log.error "========================";
       log.error "完整的MyPlugin,开始修改Class!";
       log.error "========================";
     }
    }
    
  3. resources/META-INF/gradle-plugins 目录下新建一个 .properties 文件,注意该文件的命名就是你使用此插件时的名称,这里命名为 com.app.myplugin.properties ,一定要注意后缀名称,那么使用时的名称就是com.app.myplugin,文件里面的内容填写如下:

    implementation-class=com.app.plugin.MyPlugin
    

    这里是 key = value 的形式,值就是刚刚自定义的 插件( groovy 文件 )的全名,也就是路径加上类名称。

至此,插件也就开发完成了。

这是可以发布出去的完整的插件结构,如果你想开发只针对当前项目的 Gradle 插件,那么可以简化很多步骤,也可以忽略后面的打包发布的繁琐步骤。

简化版 gradle 插件

开发仅用于当前项目的简化版 Gradle 插件的话,绝大部分与前面完整的步骤相同,只是有两点需要注意:

  1. 用于开发插件的 Module 名称必须是 BuildSrc
  2. 无须 resources 目录

整个目录结构简化了许多。

image.png

而且 build.gradle 中也去除了 maven 插件 apply plugin: 'maven' ,文件如下:

apply plugin: 'groovy'

dependencies {
  compile gradleApi() //gradle sdk
  compile localGroovy() //groovy sdk
}

repositories {
  jcenter()
}

然后就是编写的插件,MyPlugin.groovy 文件内容如下:

package com.example

import org.gradle.api.Plugin
import org.gradle.api.Project

public class MyPlugin implements Plugin<Project> {

  void apply(Project project) {
    def log = project.logger
    log.error "========================";
    log.error "精简的MyPlugin,开始修改Class!";
    log.error "========================";
  }
}

如果是使用的话,就直接在需要使用的 module 中 build.gradle 添加

apply plugin: com.example.MyPlugin //注意,这里没有单引号,直接填写插件的全名

然后,先 clean 下项目,然后 make project ,就可以在控制台看到效果:

image.png

插件的发布

当然,如果你想复用 你的gradle 插件,那就必须把它发布出去。

按发布的地点分类,有两种:

  1. 发布到本地仓库
  2. 发布到远程仓库

本地仓库

如果是发布到本地,则在插件的build.gradle 中添加如下代码 :

uploadArchives {
    repositories.mavenDeployer {
        repository(url: uri('../repo')) //仓库的路径,此处是项目根目录下的 repo 的文件夹
        pom.groupId = 'com.app.plugin'  //groupId ,自行定义,一般是包名
        pom.artifactId = 'gradleplugin' //artifactId ,自行定义
        pom.version = '1.0.0' //version 版本号
    }
}

此处的 groupIdartifactIdversion 这三个参数都是自定义的,后面再引用这个插件时会用到。

maven 本地仓库的目录就是当前项目目录下的 repo 目录,这个时候右侧的 gradle Toolbar 就会在module下多出一个task ,upload-uploadArchives ,在运行这个Task 之前,需要先 clean 项目。运行过后,就会在项目中生成一个 repo 的文件夹,里面就存放着发布的 gradle 插件。

image.png

使用时,需要在根目录的 build.gradle 中添加如下代码:

buildscript {
    repositories {
      //首先需要配置本地的 maven 仓库地址,这里填写的是相对路径,也可以是全路径
        maven {
            url uri('repo') 
        }
    }
    dependencies {
        //然后,添加依赖的插件,形式是 groupId:artifactId:version
        //这些都是插件发布时,定义的名称
        classpath 'com.app.plugin:gradleplugin:1.0.0' 
    }
}

最后,在使用的 module 的 build.gradle 里,添加

apply plugin: 'com.app.plugin.myplugin' //这里就填写 .properties 文件的名称

这就完成了本地仓库的插件使用。重新构建工程后,效果如下:

image.png

远程仓库

发布插件到远程仓库的方法,我在网上搜索到几个方案,都不成功。

幸好 有 Gradle Plugins 这样一个门户网站,让我们可以快速发布 Gradle 的插件,它有一个使用的教程文档,在这里放上 地址 ,你也可以直接看文档。

现在来简单介绍如果使用:

  1. 首先需要在这个门户网站 https://plugins.gradle.org/ 中注册账户,它也可以支持 Github 账户登录。

  2. 然后在自己的账户界面,点击 API Keys ,获取 key 和 secret ,将他们 copy 到项目的 gradle.properties 文件中。

image.png
  1. 然后在将要发布的插件 module 的 build.gradle 文件中做如下配置:

    apply plugin: 'groovy'
    apply plugin: "com.gradle.plugin-publish"
    
    dependencies {
       compile gradleApi() //gradle sdk
       compile localGroovy() //groovy sdk
    
        //这里根据插件需要,添加对应的依赖
       compile 'com.android.tools.build:gradle:3.0.0'
       compile 'org.javassist:javassist:3.20.0-GA'
    }
    repositories {
       jcenter()
    }
    
    buildscript {
       repositories {
           maven {
               url "https://plugins.gradle.org/m2/"
           }
       }
       dependencies {
           classpath "com.gradle.publish:plugin-publish-plugin:0.9.7"
       }
    }
    
    repositories {
       mavenCentral()
       jcenter()
    }
    
    version = "1.0.0"    //配置插件的版本号
    group = "com.deemons.gradlePlugin"   //插件的群组,插件的classpath会用到
    
    pluginBundle {
    
       website = 'http://www.gradle.org/'
       vcsUrl = 'https://github.com/gradle/gradle'
       description = 'javassist for okbus'  //插件描述
       tags = ['okbus', 'javassist']  //插件的tag。可以通过这个在插件门户上搜索
    
       plugins {
           greetingsPlugin {
               id = 'com.deemons.bus'   //插件的id,到时候apply的插件id
               displayName = 'OkBus plugin'
           }
       }
    }
    
  2. 添加完成后并且同步后,右侧对应模块的 Tasks 目录下,会多出 plugin portal ,然后点击 publishPlugins 就完成发布了。

如果不出意外,插件就已经上传好了,这时候在 Plugins 上就可以搜索到自己的插件了。

image.png

点击进入,查看插件详情,里面会告诉你这个插件是如何使用的,是不是非常方便~

image.png

这篇文章只是简单的介绍了 gradle 插件的开发,但真正有难度的是插件的内容。比如,结合 AspectJ 或者javassist 完成功能强大的插件,例如 TinkerRePluginVirtualAPK 等。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,921评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,635评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,393评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,836评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,833评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,685评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,043评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,694评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,671评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,670评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,779评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,424评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,027评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,984评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,214评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,108评论 2 351
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,517评论 2 343

推荐阅读更多精彩内容