时间:2021-11-04 10:02:05 | 栏目:Android代码 | 点击:次
我们知道在我们现在使用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是一种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(){ } }
自定义插件的方式:
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插件的,实现、上传、使用过程