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插件的,实现、上传、使用过程
到此这篇关于Android自定义Gradle插件的文章就介绍到这了,更多相关Android自定义Gradle插件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!
您可能感兴趣的文章:
- 为Android Studio编写自定义Gradle插件的教程
- 详解如何使用Android Studio开发Gradle插件
- 详解Android Gradle插件3.0挖坑日记
- Android gradle插件打印时间戳的方法详解
- Android Studio Gradle插件版本与Gradle版本之间的对应关系
- AndroidStudio升级4.1坑(无法启动、插件plugin不好用、代码不高亮)
- AndroidStudio升级4.1后启动失败Plugin问题解决
- 解决Android Studio4.1没有Gsonfomat插件,Plugin “GsonFormat” is incompatible的问题
- Android Studio 中Gradle配置sonarqube插件(推荐)
- Android Gradle 插件自定义Plugin实现注意事项