Android自定义Gradle插件的详细过程
一、Gradle
我们知道在我们现在使用Android Stduio开发Android项目的时候，Android Studio是基于Gradle来帮助我们构建，管理项目的。
Gradle:Gradle是一个项目构建工具，用来帮助我们管理项目的依赖、打包、发布、部署等工作。
Gradle是通过如build.gradle这种gradle脚本来进行项目构建的,所以我们对项目的构建配置都是可以写在gradle构建脚本中。
gradle构建脚本使用的是Groovy语言,Groovy语言也是一种jvm语言，最终也是编译成class文件然后在jvm上执行,所以所有的Java语言的特性Groovy都支持，我们可以完全混写Java和Groovy;
Gradle插件：
Gradle是一个构建项目的工具，但是Gradle本身只提供了一个核心框架，各种构建功能，比如编译、依赖、打包等都是通过插件来完成的;
比如我们使用构建Android项目，就需要可以构建Android的gradle插件，所以我们在Android Studio中新建的每一个项目中都会在Project的build.gradle中都会引入构建Android项目的插件
dependencies {
classpath "com.android.tools.build:gradle:4.1.3"
}
这个Gradle插件是Google开发的gradle插件，插件中实际上是定义了一系列的Task,这些Task的执行对应的就是一系列的构建操作，如build(编译)、install(安装)等，而构建Android项目的gradle插件就定义了如build、install等Task;
除了使用Google以及其他开发好的一些插件，我们自己也可以开发Gradle插件,来帮助我们自动完成一些任务，比如多渠道打包插件，比如每次发布APK之前，可能还需要对APK进行加固，所以也可以开发一个加固插件;这样，引入插件之后，在Gradle窗口中，直接点击对应的Task,就会自动加固了，非常方便；
自定义插件也是使用Groovy语言来进行开发；
二、Groovy语法
上面我们说过Groovy是一种JVM语言，可以完全使用Java语法编写代码，但是Groovy也是 有自己的语法的，我们现在来学习一下Groovy的基本语法;
（1）Groovy中变量和方法的声明
Groovy中通过def关键字来声明变量和方法
def a=1;
def b="hello world";
def int c=1;
def test(){ //定义方法
println("123");
return 0;
}
Groovy写法相对来说比较随意，很多东西都是可以省略的;
语句结尾的分号可以省略；
定义变量和方法时，变量的类型，和方法的返回值也可以省略;
Groovy中类型是弱化的，类型是可以动态推断的;
Groovy中很多东西都是可以省略的：
方法调用时，括号也是可以省略的
方法的返回值，return都是可以省略的
def a=1;
a="Hello World"
def test(a){
println(a);
1; //方法的返回值为1，返回值可以省略return
}
test 1 //调用方法，可以省略括号
(2) Groovy中的数据类型
基本数据类型
Java中的基本数据类型，Groovy中都是有的;
但是不同的是，Groovy中的基本数据类型都是以对象的类型存在的；
def int a=1;
def double b=1.1;
println(a.class);
println(b.class);
对象类型
和Java中的对象类型是一样的
这里把String类型单独拿出来说下,因为Groovy中字符串的拼接比较有特色的,可以在字符串中使用 ${变量}，来拼接变量的值
def a=1;
String b="Hello ${a}" //字符串结果为 Hello 1
(3) 闭包Closure
Groovy中的闭包是一个开放的、匿名的代码块，可以接受参数，返回值并分配给变量
{ [closureParameters] -> statements }
//定义闭包
def closure = { println("Hello World") }
def closure1= { a,b -> a+b }
//调用闭包
closure();
closure.call(); //函数式调用或者使用call方式调用,这两种方式调用闭包都是可以的
def a=closure1(1,2);
def a=closure1.call(1,2);
(4) Grovvy中的数据结构
前面我们说过Java中的东西，Grovvy中都是可以使用，所以Java中的数据结构，Grovvy中当然都是可以使用的;
这里主要学习下Grovvy中和Java中不同的常用语法：
List集合
//先写一个Java中的语法
List list=new ArrayList<>();
list.add(1);
list.add(2);
//Groovy除了像Java中一样写法，还可以这样来定义List
def lists=[1,2,3];
lists.add(4);
lists.add(5);
print(lists.class); //我们打印这个lists的class,它就是java.util.ArrayList
当然既然它就是Java中的ArrayList,当然还有remove,get等等API,这里就不一一列出来了,但是Groovy中List还提供了find查找的API，这个是Java中所没有的
def result=lists.find{
return it%2==0;
} //这里find查找方法传入的参数是一个闭包，返回的是第一个能整除2的元素
def results=lists.findAll {
return it%2==0;
} //查找List中所有的能整除2的元素
def resList=lists.sort {
x1,x2-> return x1==x2?0:x1>x2?1:-1
} //List中sort方法，传入一个闭包参数，用于对List排序
lists.each{
print(it+",");
} //each方法遍历List
List还有一些其他方法，这里可不一一列举了
Map
//先写一个Java中Map的写法
Map map=new HashMap<>();
map.put("a",1);
map.put("b",2);
//Groovy除了像Java中一样写法，还可以这样来定义Map
def map=["a":1,"b":2];
prinlt(map.get("a")); //获取某个键对应的值
prinltn(map.a);//map.key 这种方式也可以获取map中某个键的值
println(map.getClass()); //这样定义map,Map的默认数据类型是java.util.LinkedHashMap
//这里我们是使用map.getClass()来获取map的类，而不能map.class来获取
//是因为map有map.key这种用法，用来获取map中键为key的值，所以如果写map.class
//会被认为是获取map中键为class的值，所以这里只能用map.getClass()来获取map的class类型
def v=map.find {
if (it.getValue()==2){
return it;
}
} //map中的find方法，传入一个闭包参数,可以查找map中第一个满足条件的一个Entry(键值对实体)
println(v.key);
map.each {
println(it.getKey()+":"+it.getValue());
} //可以使用map的each方法，参数是一个闭包，来遍历map
map还有一些其他方法，所以这里可不一一列举了
def resMap=map.sort {
e1,e2->
return e1.key==e2.key?0:e1.key>e2.key?1:-1
} //map的sort方法传入一个闭包参数,对map进行排序，返回的是一个排序后的新的map,注意原map并没有变化
Range (范围)
rang相当于一个轻量级的List
def rang=1..10 //这里相当于定义了一个集合，集合中的元素值从1到10
println(range.class); //groovy.lang.IntRange
println(rang[0]) //range[0]为1
println(range.getFrom());// 1 range.getFrom() 获取range的下限值
println(range.getTo()); //10 range.getTo()获取range的上限值
//如果定义的def range=10..1; range.getFrom()和range.getTo()的值还是1,10
//因为10..1 下限值还是1，上限值还是10
def charRange='f'..'a';
charRange.each {
println(it)
} //打印出 f,e,d,c,b,a
def score=60;
switch (score){
case 0..59:
println("及格");
break
case 60..85:
println("及格");
break
case 86..100:
println("优秀");
break
}
(5)Groovy中的class(类)、inteface(接口)、trait
class
Groovy中的class(类)和Java中的class(类)是一样的，唯一的区别在于
默认的类、成员、方法的访问权限都是public的
interface
Groovy中的interface(接口)和Java中的interface(接口)是一样的,区别可能还是Groovy中定义接口的时候，如果不写访问权限默认就是public的而Java中定义接口的时候，如果不写访问权限，默认不是public的，那么不同包下的类是无法访问这个接口的;
trait
trait这个是Groovy中新加的类型，但是其实他就是一种介于抽象类和接口之间的类型；trait中可以定义抽象方法(即不实现)，也可以定义正常方法； 使用的时候，和接口一样，也是要implement的,非抽象类实现是需要实现其抽象方法
trait MyTrait{
abstract void test();
void play(){
prinlt("play game");
}
}
class TestClass implement MyTrait{
@Override
void test(){
}
}
三、自定义Gradle插件
自定义插件的方式：
1.独立项目
一个独立的Java项目/模块，可以将文件包发布到仓库(jcenter),使其他项目方便引用
2.Build script脚本
把插件写在build.gradle文件中，一般用于简单的逻辑，只在该build.gradle中可见
3.buildSrc目录
将插件源码放在buildSrc/src/main/groovy/中，只对该项目可见
我们这里以独立的Java Library模块自定义插件方式为例，来学习一下如何自定义一个Gradle插件;
每次发布APK之前，可能还需要对APK进行加固，所以也可以开发一个加固插件,来自动进行APK加固,我们这里以开发一个360加固插件为例；
我们知道如果是手动使用360加固，我们肯定是需要打开360加固的软件，然后输入用户名，密码登录进软件，然后选择应用加固选项，上传打包好的APK文件,就会自动进行加固，加固好之后，就会自定下载加固好的APK，然后我们还需要对加固好的APK文件进行签名，签名后的加固APK文件就可以正常安装使用了;
如果我们是使用自定义插件的方式来自动完成360加固，那上面这些步骤，从登录开始到上传应用，到加固，到对加固后的应用进行签名，都要以代码的方式来实现；
（1）我们使用Android Studio来创建一个正常的Android项目，在Android项目中新建一个Java Library Module;
Java Library Module名字，这里我们取plugin
Module的build.gradle文件中引入groovy插件，dependencies中
引入gradle插件，以及gradleApi因为在编写插件的时候，是要用到gradle相关的API的
plugins { id 'groovy' } 或者 apply plugin:'groovy'
dependencies {
implementation 'com.android.tools.build:gradle:4.1.3'
implementation gradleApi()
}
(2) Android Studio 切换项目试图为Project,然后修改plugin的src/main/java 这个java目录名字为groovy
(3) 然后在src/main/groovy/…(包名)/下新建插件源码文件
这里要新建File(注意这里必须要新建一个File，不是新建java ,class等),File文件的名字以.groovy后缀结尾
我们这里新建一个GiaGuTask.groovy 的File，然后在GiaGuTask.groovy中开始插件的开发：首先要先添加包名,由于 Android Stuido不能识别.groovy文件 所以不会给我们自动添加包名，所以需要我们自己添加包名;package com.example.plugin
这个Task中就是将上述的登录360加固软件，上传APK,加固，签名加固后的APK文件，全部用执行命令的方式来实现,360加固软件包下的help.txt中实际上就提供了上 登录360加固软件，上传APK,加固，签名加固后的APK文件的命令行命令
所以我们的新建的Task如下：
package com.example.plugin
import com.android.builder.model.SigningConfig
import org.gradle.api.DefaultTask
import org.gradle.api.tasks.TaskAction
class GiaGuTask extends DefaultTask{
GiaGuBean mGiaGuBean;
SigningConfig signingConfig;
File apkFile;
GiaGuTask() {
group="jiagu"
}
@TaskAction
void run() {
project.exec {
it.commandLine(
"java",
"-jar",
mGiaGuBean.getJiaGuTools(),
"-login",
mGiaGuBean.getUserName(),
mGiaGuBean.getPassword(),
);
}
if (signingConfig) {
project.exec {
it.commandLine(
"java",
"-jar",
mGiaGuBean.getJiaGuTools(),
"-importsign",
signingConfig.storeFile.absolutePath,
signingConfig.storePassword,
signingConfig.keyAlias,
signingConfig.keyPassword
)
}
}
project.exec {
it.commandLine("java",
"-jar",
mGiaGuBean.getJiaGuTools(),
"-jiagu",
apkFile.absolutePath,
apkFile.parent,
"-autosign"
)
}
}
}
当然这里的GiaGuTask使用到了一个GiaGuBean,这个GiaGuBean里面定义了一些我们需要到时候在build.gradle
设置的配置信息，登录的用户名，密码，加固工具所在的位置(加固工具就是360加固软件包下的jiagu.jar文件)
这些需要从build.gradle中设置的配置信息，我们需要在GiaGuBean这个实体类中定义，并且定义set,get方法
package com.example.plugin
class GiaGuBean {
String userName;
String password;
String jiaGuTools
String getUserName() {
return userName
}
void setUserName(String userName) {
this.userName = userName
}
String getPassword() {
return password
}
void setPassword(String password) {
this.password = password
}
String getJiaGuTools() {
return jiaGuTools
}
void setJiaGuTools(String jiaGuTools) {
this.jiaGuTools = jiaGuTools
}
}
然后新建一个GiaGuPlugin.groovy 的File，然后定义一个class GiaGuPlugin 需要实现 DefaultPlugin
并且实现apply方法，在apply方法中进行相应的实现,并且创建一个或者多个Task的,因为最终的插件功能，都是一个个Task的执行
package com.example.plugin
import com.android.build.gradle.AppExtension
import com.android.build.gradle.api.ApplicationVariant
import com.android.build.gradle.api.BaseVariantOutput
import com.android.builder.model.SigningConfig
import org.gradle.api.Plugin
import org.gradle.api.Project
class GiaGuPlugin implements Plugin<Project>{
@Override
void apply(Project project) {
GiaGuBean giaGuBean = project.extensions.create("jiagu", GiaGuBean.class);
project.afterEvaluate {
AppExtension appExtension = project.extensions.android;
appExtension.applicationVariants.all {
//debug/release
ApplicationVariant variant ->
//对应变体(debug/release)的签名配置
SigningConfig signingConfig = variant.signingConfig;
variant.outputs.all {
BaseVariantOutput baseVariantOutput ->
//输出的APK文件
File apkFile = baseVariantOutput.outputFile;
//创建加固任务
GiaGuTask giaGuTask = project.tasks.create("jiagu${variant.baseName.capitalize()}", GiaGuTask.class);
giaGuTask.mGiaGuBean = giaGuBean;
giaGuTask.signingConfig = signingConfig;
giaGuTask.apkFile =apkFile;
}
}
}
(4)插件的配置
插件开发好了之后，就需要进行配置，plugin Module的src/main目录下新建一个resources目录，再在resources目录下新建一个META-INF目录，再在META-INF目录下新建一个gradle-plugins目录； 然后在gradle-plugins目录下新建一个以 .properties后缀的文件,这个文件的名字就是到时候我们在引用插件时的名字我们这里取名:com.example.plugin.properties;这个文件里面我们需要配置插件的实现类
implementation-class=com.example.plugin.GiaGuPlugin
到时候我们引用插件的时候就使用com.example.plugin这个名字；
(5)打包插件上传仓库
我们这里是打包插件上传Maven本地仓库,需要依赖maven-plugin插件,所以在plugin这个Java Library Module的build.gradle中添加maven-plugin插件的使用
apply plugin:'maven-publish'
publishing{
publications{
Jiagu(MavenPublication){ //Jiagu 这个名字随意取
from components.java //这个表示要把源码生成的jar包上传
groupId 'com.example' //配置插件的groupId(分组ID)
artifactId "plugin" //配置ID
version "1.0" //配置版本号
}
}
}
groupId、artifactId、version这三个配置构成了到时候我们依赖插件的时候的写法: groupId:artifactId:version，我
们到时候依赖这个plugin插件的时候，应该是在Android项目的Project的build.gradle的dependencies中添加依赖:classpath “com.example:plugin:1.0”
引用maven-publish插件之后，build(编译) plugin module之后，我们就可以在gradle窗口中查看到plugin下Tasks下会有publishing的Task，点开publishing这个Task下，我们点击publishToMavenLocal(打包上传插件到本地的maven库),操作成功过后,在C:\Users\Administrator\下回有一个.m2目录，这个目录的repository目录下会有 com\example\plugin这个目录所以是1.0(version)目录下就会有对应的插件plugin-1.0.jar,和两个插件信息文件：plugin-1.0.module、plugin-1.0.pom;
(5)使用插件
添加插件的依赖
我们在Android项目中的Project的build.gradle中添加插件依赖 由于我们使用的是本地maven库中的插件，所以repositories中需要添加mavenLocal()仓库
repositories {
...
mavenLocal()
}
dependencies {
...
classpath "com.example:plugin:1.0"
//就是之前上传的是偶配置groupId:artifactId:version
}
引用插件
在Android项目主module(一般为app)的build.gradle中引用插件
apply plugins:'com.example.plugin' //就是开发插件的时候resources/META-INF/gradle-plugins/com.example.plugin.properties 这个文件的名字
或者现在都是这种写法，在plugins{}下添加插件ID
plugins {
...
id 'com.example.plugin'
//就是开发插件的时候resources/META-INF/gradle-plugins/com.example.plugin.properties 这个文件的名字
}
当然app主module中的build.gradle中还要配置之前在定义GiaGuBean中的登录用户名，密码，加固工具位置信息
执行插件任务
上述步骤之后，就会在gradle窗口中主module(app)的Tasks下会有一个jiagu任务,这个名字实际就是你开发插件的 时候,定义Task时候，为Task设置的groupId,如果没有设置task的groupId，则插件的任务会在module(app)Tasks的other目录下点击jiagu下的操作，就会执行我们的加固任务;
当然我们要先确保APK文件已经存在，因为之前我们定义GiaGuPlugin.groovy时，里面APK文件使用的是baseVariantOutput.outputFile，也即build/outputs/apk/下release或者debug目录下的APK，所以我们只要build一下就会生成APK文件，然后我们再点击gradle窗口下，app/Tasks/jiagu下的加固任务即可进行加固
整个加固的过程，在run窗口下都会有日志打印
加固任务执行完毕之后build/outputs/apk/ 对用的目录下就会生成加固签名后的APK文件
以上就是一个自定义gradle插件的，实现、上传、使用过程
