开发效率优化之自动化构建系统Gradle(二)上篇
阿里P7移动互联网架构师进阶视频(每日更新中)免费学习请点击:https://space.bilibili.com/474380680
本篇文章将以下两个内容来介绍自动化构建系统Gradle:
- gradle 与 android gradle 插件的关系
- Gradle Transform API 的基本使用
一、gradle 与 android gradle 插件的关系
1.1名词解释:
1.1.1,Gradle
Gradle是一种构建工具,它使用一种基于Groovy的特定领域语言(DSL)来构建项目。不仅仅用于android 工程的构建。
1.1.2,Android Plugin for Gradle
这就是为了编译android 工程而开发的插件。下面就是申明Android Gradle 插件的位置。(build.gradle)
buildscript { ... dependencies { classpath 'com.android.tools.build:gradle:2.2.0' } }
1.2 gradle 与 android gradle
1.2.1,gradle 各版本源码地址
http://services.gradle.org/distributions/
1.2.2, google 官网 gradle 插件 与 gradle 版本对照地址
https://developer.android.google.cn/studio/releases/gradle-plugin#updating-plugin
1.2.3,gradle 版本与google gradle 插件版本的区别
在gradle wrapper.properties 中写的是 gradle 版本。
distributionUrl=https\://services.gradle.org/distributions/gradle-4.4-all.zip
在build.gradle 中依赖的是 gradle插件版本。
dependencies { //[this is the android gradle plugin version] classpath 'com.android.tools.build:gradle:3.1.0' // NOTE: Do not place your application dependencies here; they belong // in the individual module build.gradle files }
二、Gradle Transform API 的基本使用
2.1什么是Transform
我们编译Android项目时,如果我们想拿到编译时产生的Class文件,并在生成Dex之前做一些处理,我们可以通过编写一个Transform
来接收这些输入(编译产生的Class文件),并向已经产生的输入中添加一些东西。
我们可以通过Gradle插件来注册我们编写的Transform
。注册后的Transform
会被Gradle包装成一个Gradle Task
,这个TransForm Task会在java compile Task
执行完毕后运行。
对于编写Transform
的API, 我们可以通过引入下面这个依赖来使用:
compile 'com.android.tools.build:gradle:2.3.3' //版本应该在 2.x以上
先大致看一下Transform
的执行流程图:
2.2 Transform的使用场景
一般我们使用Transform
会有下面两种场景
- 我们需要对编译class文件做自定义的处理。
- 我们需要读取编译产生的class文件,做一些其他事情,但是不需要修改它。
接下来我们就来看一下这些Transform API
吧 :
2.3 Transform API学习
我们编写一个自定义的transform需要继承Transform
,它是一个抽象类, 我们这里先看一下Transform
的抽象方法:
public abstract class Transform { public abstract String getName(); public abstract Set<ContentType> getInputTypes(); public abstract Set<? super Scope> getScopes(); public abstract boolean isIncremental(); // 是否支持增量编译 }
getName()
就是指定自定义的Transform
的名字。
2.4 输入的类型
Set<ContentType> getInputTypes()
是指明你自定义的这个Transform
处理的输入类型,输入类型共有以下几种:
enum DefaultContentType implements ContentType { /** * The content is compiled Java code. This can be in a Jar file or in a folder. If * in a folder, it is expected to in sub-folders matching package names. */ CLASSES(0x01), /** * The content is standard Java resources. */ RESOURCES(0x02); }
即分为class文件或者java资源。class文件来自于jar或者文件夹。资源就是标准的java资源。
2.5 输入文件所属的范围 Scope
getScopes()
用来指明自定的Transform
的输入文件所属的范围, 这是因为gradle是支持多工程编译的。总共有以下几种:
/** * This indicates what the content represents, so that Transforms can apply to only part(s) * of the classes or resources that the build manipulates. */ enum Scope implements ScopeType { /** Only the project content */ PROJECT(0x01), //只是当前工程的代码 /** Only the project's local dependencies (local jars) */ PROJECT_LOCAL_DEPS(0x02), // 工程的本地jar /** Only the sub-projects. */ SUB_PROJECTS(0x04), // 只包含子工工程 /** Only the sub-projects's local dependencies (local jars). */ SUB_PROJECTS_LOCAL_DEPS(0x08), /** Only the external libraries */ EXTERNAL_LIBRARIES(0x10), /** Code that is being tested by the current variant, including dependencies */ TESTED_CODE(0x20), /** Local or remote dependencies that are provided-only */ PROVIDED_ONLY(0x40); }
对于getScopes()
的返回,其实TransformManager
已经为我们定义了一些,比如:
public static final Set<Scope> SCOPE_FULL_PROJECT = Sets.immutableEnumSet( Scope.PROJECT, Scope.PROJECT_LOCAL_DEPS, Scope.SUB_PROJECTS, Scope.SUB_PROJECTS_LOCAL_DEPS, Scope.EXTERNAL_LIBRARIES);
如果一个Transform不想处理任何输入,只是想查看输入的内容,那么只需在getScopes()
返回一个空集合,在getReferencedScopes()
返回想要接收的范围。
public Set<? super Scope> getReferencedScopes() { return ImmutableSet.of(); }
2.6 transform()
它是Transform
的关键方法:
public void transform(@NonNull TransformInvocation transformInvocation) {}
它是一个空实现,input
的内容将会打包成一个TransformInvocation
对象,因为我们要想使用input
,我们需要详细了解一下TransformInvocation
参数。
2.7 TransformInvocation
我们看一下这个类相关的API:
public interface TransformInvocation { Collection<TransformInput> getInputs(); // 输入作为 TransformInput 返回 TransformOutputProvider getOutputProvider(); //TransformOutputProvider 可以用来创建输出内容 boolean isIncremental(); } public interface TransformInput { Collection<JarInput> getJarInputs(); Collection<DirectoryInput> getDirectoryInputs(); } public interface JarInput extends QualifiedContent { File getFile(); //jar文件 Set<ContentType> getContentTypes(); // 是class还是resource Set<? super Scope> getScopes(); //属于Scope: } DirectoryInput与JarInput定义基本相同。 public interface TransformOutputProvider { //根据 name、ContentType、QualifiedContent.Scope返回对应的文件( jar / directory) File getContentLocation(String name, Set<QualifiedContent.ContentType> types, Set<? super QualifiedContent.Scope> scopes, Format format); }
即我们可以通过TransformInvocation
来获取输入,同时也获得了输出的功能。举个例子,
public void transform(TransformInvocation invocation) { for (TransformInput input : invocation.getInputs()) { input.getJarInputs().parallelStream().forEach(jarInput -> { File src = jarInput.getFile(); JarFile jarFile = new JarFile(file); Enumeration<JarEntry> entries = jarFile.entries(); while (entries.hasMoreElements()) { JarEntry entry = entries.nextElement(); //处理 } } }
上面这段代码就是获取jar的输入,然后遍历每一个jar做一些自定义的处理。
我们在做完自定义的处理后,如果想自己输出一些东西怎么办? 比如一个class文件,就可以通过TransformOutputProvider
来完成。比如下面这段代码:
File dest = invocation.getOutputProvider().getContentLocation("susion", TransformManager.CONTENT_CLASS, ImmutableSet.of(QualifiedContent.Scope.PROJECT), Format.DIRECTORY;
这段代码就是在本工程(ImmutableSet.of(QualifiedContent.Scope.PROJECT)
)下产生一个目录(Format.DIRECTORY
), 目录的名字是(susion
),里面的内容是TransformManager.CONTENT_CLASS
。
创建这个文件夹后,我们就可以向其中写入一些内容,比如class文件。
2.8 注册Transform
我们在了解transform api
后,我们可以编写一个自定义的Transform
。但是我们编写的这个Transform
,如何在构建过程中生效呢?我们需要注册它
在自定义插件中注册它,然后在build.gradle
中apply
就可以了。
//MyCustomPlgin.groovy public class MyCustomPlgin implements Plugin<Project> { @Override public void apply(Project project) { project.getExtensions().findByType(BaseExtension.class) .registerTransform(new MyCustomTransform()); } }
其实如果你包含了你编写的transform库,我们也可以直接在build.gradle
中注册:
//在build.gradle中也是可以直接编写 groovy代码的。 project.extensions.findByType(BaseExtension.class).registerTransform(new MyCustomTransform());
参考:https://www.jianshu.com/p/031b62d02607
https://my.oschina.net/u/592116/blog/1851743
阿里P7移动互联网架构师进阶视频(每日更新中)免费学习请点击:https://space.bilibili.com/474380680
结束语
希望读到这的您能转发分享和关注一下我,以后还会持续分享阿里P7 Android高级架构进阶知识点及解析,您的支持就是我最大的动力!!
低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。
持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。
- 上一篇
OkHttp3源码详解(二) 整体流程
1.简单使用 同步: @Override public Response execute() throws IOException { synchronized (this) { if (executed) throw new IllegalStateException("Already Executed"); executed = true; } try { client.dispatcher().executed(this); Response result = getResponseWithInterceptorChain(false); if (result == null) throw new IOException("Canceled"); return result; } finally { client.dispatcher().finished(this); } } 首先加锁置标志位,接着使用分配器的executed方法将call加入到同步队列中,然后调用getResponseWithInterceptorChain方法(稍后分析)执行http请求,最后调用finis...
- 下一篇
Android直播带货系统中如何实现二维码扫描功能
Android直播带货系统中如何实现二维码扫描功能 李佳琦的出现将直播带货成功的引向了“巅峰”,为了响应众平台和用户的需求,开发Android直播带货系统成为当下的开发热潮。那么在平时的直播软件中,登录、分享、支付等场景中经常出现扫描二维码的需求。接下来就以云豹直播app中的二维码扫描功能为例,跟大家简单分享下怎样搞笑、快捷、稳定的实现这个功能。目前github上关于Android直播带货系统实现二维码的库最有名的是Google的Zxing,但是Zxing集成复杂,体积大,扫描识别比较慢,而且封装的不好,使用不方便。这里推荐Zbar,Zbar具有识别快,集成方便等优点。实际开发中我们推荐使用bingoogolapple/BGAQRCode-Android 这个库,这个是对Zbar的进一步封装,集成使用更加方便。 1)首先将这个库集成到项目中 compile 'cn.bingoogolapple:bga-qrcode-zbar:1.3.6' 2)在需要扫码的activity的布局文件中加入 <?xml version="1.0" encoding="utf-8"?> xmln...
相关文章
文章评论
共有0条评论来说两句吧...
文章二维码
点击排行
推荐阅读
最新文章
- CentOS6,CentOS7官方镜像安装Oracle11G
- CentOS7安装Docker,走上虚拟化容器引擎之路
- CentOS7设置SWAP分区,小内存服务器的救世主
- Docker使用Oracle官方镜像安装(12C,18C,19C)
- CentOS7编译安装Gcc9.2.0,解决mysql等软件编译问题
- CentOS7编译安装Cmake3.16.3,解决mysql等软件编译问题
- CentOS8安装Docker,最新的服务器搭配容器使用
- Docker安装Oracle12C,快速搭建Oracle学习环境
- CentOS关闭SELinux安全模块
- CentOS6,7,8上安装Nginx,支持https2.0的开启