自定义Gradle插件(一)

时间:2021-11-21 17:17:16

自定义Gradle插件(一)

自定义Gradle插件(二)

Google已经建议Android开发全部转向Android Studio开发,Android Studio 是使用gradle编译、打包的,那么问题来了,gradle可是有一堆东西...,为了测底了解gradle,今天就来学习下如何写自己的gradle插件(当然插件源码是使用groovy写的),先看如下代码目录:

自定义Gradle插件(一)

如上图所示,plugin目录是插件源码目录,sample是用来测试插件的。


1、在目录plugin/src/main/groovy/com/micky/gradle/下新建插件类MyCustomPlugin.groovy

package com.micky.gradle;

import org.gradle.api.*;

class MyCustomPlugin implements Plugin<Project> {
void apply(Project project) {
project.task('myTask') << {
println "Hi this is micky's plugin"
}
}
}

看看Plugin的源码,其实就是一接口

public interface Plugin<T> {
/**
* Apply this plugin to the given target object.
*
* @param target The target object
*/
void apply(T target);
}


2、在目录plugin/src/main/resources/META-INF/gradle-plugins/下创建文件com.micky.mycustom.properties用来指定插件实现类

implementation-class=com.micky.gradle.MyCustomPlugin

   特别注意下:文件名“com.micky.mycustom”即是以后我们在使用插件时的apply plugin 'java' 的java,这里我也是折腾了半天才得出的结果,坑啊。


3、一般情况下,我们还需要指定插件项目名称,在plugin目录下新建settings.gradle

rootProject.name='gradle-micky'

4、万事具备,就差编译了,编译需要在plugin目录下新建build.gradle

apply plugin: 'groovy'
apply plugin: 'maven'

dependencies {
compile gradleApi()
compile localGroovy()
}

repositories {
mavenCentral()
}

group='com.micky'
version='1.0.0'

uploadArchives {
repositories {
mavenDeployer {
repository(url: uri('../repo'))
}
}
}
在这个脚本里使用groovy插件编译groovy源码,声明gradleAPI作为即时编译依赖,apply plugin: 'maven' 是用来创建一个插件jar文件并且存储在本地maven库里,本地maven库即我们在脚本里创建的"../repo"目录

执行命令:   gradle uploadArchives

自定义Gradle插件(一)


5、以上4个步骤已经编译插件并上传到了本地库中,接下来就看看怎么使用插件,在sample目录下,新建build.gradle

buildscript {
repositories {
maven {
url uri('../repo')
}
}

dependencies {
classpath group: 'com.micky',
name: 'gradle-micky',
version: '1.0.0'
}
}

apply plugin: 'com.micky.mycustom'

6、执行命令

自定义Gradle插件(一)

myTask即我们在MyCustomPlugin.groovy代码中创建的任务,下一编我们将来自定义Gradle 的Task。


源码地址:https://github.com/mickyliu945/GradleCustomPlugin