android aar保存图片文件异常_我去!合并AAR时踩坑了!
点击上方“刘望舒”,马上关注,早上8:42推送
真爱,请置顶或星标
作者: leeon7
https://www.jianshu.com/p/8f7e32015836
背景
在输出Android模块时,有时会因为个别原因(比如来自业务的不可抗力),要求将模块打包成一个文件提供给接入方。这就意味着在输出模块由多个子模块组成的情况下,我们需要把多个AAR(或JAR)合并成一个大AAR输出,这个合并过程涉及到了很多有用的知识和难点,这篇文章就详细解析下其中的内容。
首先来直观认识下AAR
AAR文件是一种Android归档包(类比Jar:Java Archive),这种归档包是由Gradle构建库的Android Library插件产出的。它是一个压缩包,里面的内容可以总结为5个目录和5个文件:
卖个关子,在上面10个内容中,其中有一个是已经合并后的结果,它默认已经包含了所有子模块的内容,你能猜出来是那个么?
图里文字已经基本解释清楚了各个内容,不再赘述,现在我们根据现有的了解设想下合并AAR的大致思路:AAR里无非是几个目录和文件,所以最终AAR的5个目录下,必然包含了所有子模块的对应内容,而5个文件也肯定是各个子文件合并的结果。那么如何实现包含和合并呢?
第一反应是写个脚本对AAR们做解压、整合,再压缩的思路,但稍微推演下就知道不现实(理论上也不可行,AAR和普通压缩文件还是有区别的),再思考下,既然直接拿产物做合并不可行,能不能在构建主模块AAR时,就顺便将子模块内容纳入进来呢?
这无疑是个优雅的思路,理论上是否可行呢?答案是可以的,别忘了AAR是Android Gradle Plugin构建产出的,而Gradle强大的拓展支持刚好能实现我们的需求。所以合并AAR的方法,其实就是修改Gradle构建流程,在默认构建的基础上,插入我们自己的操作,最终产出一个包含子模块内容的大AAR。
在入题之前,有必要先理解下Gradle是如何支持构建拓展的,下图是Gradle官网截图:
Gradle
中定义了Project
和Task
两个概念,同时也将构建流程面向对象化(即构建是针对Project
执行的一系列Task
)。对Gradle的描述关键在于基于依赖编程,具体解释就是可以用Gradle来定义Task和Task间的依赖关系,最终得出一个Task的有向无环图来描述构建。
这意味着,我们需要将合并的操作封装为Task,并在合适的生命周期内,将自定义Task插入到任务图的依赖关系中去,进而得出一个新的Task图,最终构建出我们要的产物。
我们在主工程下执行./gradlew assembleRelease
,看一下默认构建中都执行了哪些Task:
可以看到依次执行了收集依赖,合并资源、Javac编译、打包文件等Task。同时,通过观察/build/intermediates
目录可以发现,不同任务会产出各自的构建中间结果,最终的AAR就是由这些中间结果打包而来的。所以理论上,我们需要在主模块执行打包Task前将子模块内容混入到中间结果中,而由于构建Task间存在依赖关系,混入操作需要分阶段、找时机执行。
合并前需要先确定到底需要合并哪些子模块。我们通过定义一个dependency configuration: emeded
来标记需要被合并的模块,然后在gradle
构建的afterEvaluate
阶段收集被emeded
依赖的模块信息:
afterEvaluate { def dependencies = new ArrayList(configurations.embedded.resolvedConfiguration.firstLevelModuleDependencies) dependencies.reverseEach { ... it.moduleArtifacts.each { artifact -> if (artifact.type == 'aar') { if (!embeddedAarFiles.contains(artifact)) { //要合并的AAR文件 embeddedAarFiles.add(artifact) } if (!embeddedAarDirs.contains(modulePath)) { ... //每个AAR的解压目录 embeddedAarDirs.add(modulePath) } } else if (artifact.type == 'jar') { ... //要合并的JAR文件 embeddedJars.add(artifactPath) } ... } }}
可以看出,我们收集了三个集合:
要合并的AAR文件
每个AAR的解压目录
要合并的JAR文件
AAR和JAR分开收集是因为合并这两种文件的操作不同,JAR只需纳入将其Class文件,而AAR需要合并更多内容。
下面针对AAR中的5和目录和5个文件,逐个介绍合并Task,从最简单的开始:
/assets目录
合并assets
内容的Task很简单,只需将子模块解压后的assets目录添加到主工程的assets.srcDirs
中即可
task embedAssets < embeddedAarDirs.each { aarPath -> android.sourceSets.main.assets.srcDirs += file("$aarPath/assets") }}
/res目录
通过conventionMapping
,修改构建流程task packageRecourses
的输入集合,将收集到的子模块/res
目录追加到Task输入参数中
task embedLibraryResources < def oldInputResourceSet = task_packageResources.inputResourceSets task_packageResources.conventionMapping.map("inputResourceSets") { getMergedInputResourceSets(oldInputResourceSet) }}private List getMergedInputResourceSets(List inputResourceSet) { ... List newInputResourceSet = new ArrayList(inputResourceSet) embeddedAarDirs.each { aarPath -> ... rs.addSource(file("$aarPath/res")) newInputResourceSet += rs } return newInputResourceSet}
/jni目录
遍历子模块解压目录,将其中的so
文件copy
到主工程build
目录下
task embedJniLibs < embeddedAarDirs.each { aarPath -> copy { from fileTree(dir: "$aarPath/jni") into file("$bundle_release_dir/jni") } }}
proguard.txt
注意:这个文件与AAR构建自身时的混淆操作无关,只作用于接入到宿主后的混淆操作
task embedProguard < //bundle_release_dir = "build/intermediates/bundles/release" def proguardFile = file("$bundle_release_dir/proguard.txt") //遍历aar解压目录,将子模块的proguard.txt文件内容追加到主工程build目录内的proguard.txt中 embeddedAarDirs.each { aarPath -> ... def proguardLibFile = file("$aarPath/proguard.txt") if (proguardLibFile.exists()) //调用file.append()方法可以在txt文件里追加内容 proguardFile.append("\n" + proguardLibFile.text) ... }}
AndroidManifest.xml
合并AndroidManifest
使用官方库manifest-merger
即可,这里遇到了第一个难点:想要把子模块AndroidManifest
合并进来必须使用MergeType
为APPLICATION的ManifestMerger
对象,但在这种MergeType
下会替换定义在AndroidManifest
里的PlaceHolder
,比如${applicationId}
。
然而矛盾的是,此时的构建还没有接入到宿主App,也就拿不到最终的ApplicationId
,怎么办呢?通过阅读源码发现,官方仁慈的给我们开放了一个功能位,通过在初始化ManifestMerger
对象时传入一个NO_PLACEHOLDER_REPLACEMENT
功能位,即可禁止在APPLICATION
模式下替换PlaceHolder
。
buildscript { repositories { jcenter() } dependencies { classpath 'com.android.tools.build:manifest-merger:25.3.2' }}...task embedManifests < ... embeddedAarDirs.each { aarPath -> File dependencyManifest = file("$aarPath/AndroidManifest.xml") if (!libraryManifests.contains(aarPath) && dependencyManifest.exists()) { //先收集需要合并的子模块AndroidManifest libraryManifests.add(dependencyManifest) } } ... Invoker manifestMergerInvoker = ManifestMerger2.newMerger(origManifest, mLogger, MergeType.APPLICATION) //通过Invoker.Feature.NO_PLACEHOLDER_REPLACEMENT这个Flag禁止执行PlaceHolder替换 .withFeatures(Invoker.Feature.NO_PLACEHOLDER_REPLACEMENT) manifestMergerInvoker.addLibraryManifests(libraryManifests.toArray(new File[libraryManifests.size()])) manifestMergerInvoker.setMergeReportFile(reportFile); //执行合并 MergingReport mergingReport = manifestMergerInvoker.merge(); ...}
classes.jar
这似乎是最重要的文件,但是合并方法却不难:对于AAR类型的子模块,我们需要提取两样东西:一是解压子模块内部classes.jar得到的Class文件,二是看看子模块内部有没有自身携带的JAR文件。对于Class文件,将它们copy到主工程build/intermediates/classes/release目录下,随后的构建任务会从这个目录打包出主模块的classes.jar;对于子模块内部的JAR文件,将它们和JAR类型的子模块一起,放入主工程的build/intermediates/bundles/release/libs目录下,作为依赖包携带即可
task embedClassesAndJars(dependsOn: embedRJar) <{ embeddedAarDirs.each { aarPath -> ... embeddedAarFiles.each { artifact -> ...//找到每个aar里的clasess.jar def aarFile = aarFileTree.files.find { it.name.contains("classes.jar") }// 解压clasess.jar,将classes放入build/intermediates/classes/release copy {from zipTree(aarFile) into classes_dir } } ...//找到每个aar里携带的额外jar包 FileTree jars = fileTree(dir: jar_dir, include: '*.jar', exclude: 'classes.jar') ...//放入build/intermediates/bundles/release/libs copy {from jars into file("$bundle_release_dir/libs") } }//主工程直接依赖的jar包,也放入build/intermediates/bundles/release/libs copy {from embeddedJars into file("$bundle_release_dir/libs") }}
小节
至此,我们已经合并了三个文件和四个目录:
剩下的内容里,/aidl
目录和annotation.zip
不常用到,我们暂不理会,乍一看好像已经合并完成了,只剩下个看似无害的R.txt
,它是干嘛用的?我们当真完成了么?
答案是没有,假如按照目前的改造构建出一个AAR并接入到App中运行,结果是App会在每一处使用到AAR子模块资源文件的时候崩溃,堆栈日志很简单:NoClassDefFoundError
- 没有子模块包名下的R文件。啊~忘了R文件这个东西了!可R文件不是构建时自动生成的么?没错,是自动生成的,但由于我们合并了模块,子模块将丢失它们的R文件,仔细梳理下App构建流程就会发现原因:
如图上部所示,正常情况下,不管是主模块还是子模块,都是作为一个个独立的dependence
引入到宿主工程的,App构建时会给每一个dependence生成它们包名下的R文件;而当我们自主的将一群AAR合并为一个AAR后(图下半部),对于宿主来说最后只接入了一个dependence
(主模块),子模块本该对应的dependences
不存在了,所以App构建时只给主模块生成了R文件!知道原因了,怎么解决呢?
我们知道,构建主模块时,会在/build/generated/source/r
目录下生成所有包名的R文件,当然也包括子模块R文件,那么我们把这个目录下的子模块R文件打成Jar包,放入主工程build/intermediates/bundles/release/libs
目录下,这样R.jar会作为依赖库被AAR携带,不就可以了吗?我们兴冲冲地改了脚本,再次构建运行,结果还是崩溃!看下堆栈信息,提示资源找不到:Resources$NotFoundException
,这又是为什么?R文件可是自动生成的呀?为什么生成的文件内容(也就是资源ID)找不到对应资源?
在解释原因之前,先抛几个问题:
AAR里默认有R文件么?
为什么Android Library工程生成的
R.java
里的域不是final
修饰的?生成R文件流程的输出无疑是
R.java
,那么输入是什么?
在回答这些问题之前,先复习下Java基础知识,下面是一段简单的Java代码:
public class Test { private static final int SOME_ID = 0x07111111; private int getID(){ return SOME_ID; }}
假如我们将SOME_ID
的final
修饰符去掉,那么编译后的字节码跟不去掉final
相比,会有什么不同呢?我们反编译看下结果:
//带final修饰符public class Test { private static final int SOME_ID = 118558993;
public Test() { }
private int getID() { return 118558993; }}
//不带final修饰符public class Test { private static int SOME_ID = 118558993;
public Test() { }
private int getID() { return SOME_ID; }}
对比发现,带final
时,getID()
方法直接返回了数值;而不带final
时,getID()
方法返回的是SOME_ID,即依然保留着对变量的符号引用。这个看似不起眼的差别却暗藏玄机,看下图:
如图,每个AAR被接入后,都会跟随App工程再经历一次构建,即宿主工程的构建。而我们知道,R文件是跟随每次构建重新生成的(不管是AAR的构建还是App的构建),而R.java中每个域的值是由当前工程的资源集合做排列得出的,这意味着,假如工程的资源集合发生了变化,那么R.java中域的值都可能发生变化。
对于AAR文件来说,自身工程的资源集合必然和宿主工程的资源集合不一样,或者可以这样理解,R.java的值是一次性的,它只保证在当前构建结果下有效,这次生成的R文件,不保证在下次构建后可用,这也是每次构建都重新生成R文件的原因。这样我们就找到了上面的崩溃原因和抛出的前两个问题的答案:AAR接入到App后跟随App又经历了一次构建,资源发生了重排列,所以手动打到AAR中的R文件ID值全部失效,无法再索引到资源,所以运行时崩溃。
AAR中默认没有R文件,因为带上也完全不能用。同样因为重排列,AAR无法预知自身资源接入到App后的ID值,所以Library工程生成的R.java中的域都不能用final修饰。
*:这里的逻辑很刁钻,但却很重要,是理解后续操作的前提,务必要反复品味...
那要怎么办呢?其实关键在主模块身上:合并子模块后,主模块成了所有子模块的代言人,App只需接入主模块就等于接入了所有模块。能力越大责任越大,我们赋予了主模块如此特殊的地位,那么它也应该起到足够特殊的作用,比如桥接子模块到宿主的资源索引:
//com.sub.librarypublic final class R { public static final class string { public static int some_string = com.main.library.R.string.some_string; }}
如代码所示,我们在把子模块R文件放入classes.jar
之前,手动将其中的域指向主模块R文件相同的域(正是因为这里没有final
修饰符,才能保留对主模块域的符号引用,编译后才不会变成数值而无法被更改),因为主模块R文件会跟随每一次App构建而重新生成,所以它的ID值总是新鲜可靠的,这样子模块就可以通过这个桥接拿到正确的资源索引了。这时你可能会拍案而起,不对啊,主模块没有子模块里的资源文件,为什么R文件中会有跟子模块相同的域呢?!
这其实就是上面提到的第三个问题:生成R文件流程的输出无疑是R.java
,那么输入是什么?这个问题也牵扯到本文刚开始卖的关子:那个默认包含子模块内容的文件是谁?没错,就是R.txt
(这个看似老实的东西其实坏的很 XD)。
我们知道,APK或AAR构建时会用Aapt编译资源文件,这个R.txt
正是Aapt的产物,通过在aapt package
命令后面跟上--output-text-symbols
参数得到。R.txt
中会记录下-S
参数传入的资源目录下所有的资源文件信息,一个资源占一行,格式为int type name id
,比如: int string some_string 0x7f050000
(和R文件格式一致,所以猜到了吧,R.txt
就是R.java
的种子)。
在AAR的构建中,R.txt
自然记录了Library库内的资源文件信息,不过一个很不自然的事情是,构建时aapt package
命令的-S参数传入的不是本工程/src/res
目录,而是build/intermediates/res/merged/release
目录,也就是合并子模块资源后的/res目录!所以,默认生成的R.txt
中就已经包含了所有子模块的资源文件,而这个R.txt
恰恰就是构建生成R.java
的种子文件,脚本会根据R.txt
中每一行的内容生成R.java中对应的域。这也就解释了为什么主模块的R.java会包含所有子模块的资源索引。终于,我们知道了如何处理R文件:
task redirectRJava < ... embeddedAarDirs.each { aarPath -> ... def sb = "package $subPackageName;" <'\n' <'\n' //将ID赋值为主模块包名下对应的值 sb <" public static $type $name = ${mainPackageName}.R.${subclass}.${name};" <'\n' ... //generated_rsrc_dir = "build/generated/source/r/release" mkdir("$generated_rsrc_dir/$packagePath") file("$generated_rsrc_dir/$packagePath/R.java").write(sb.toString()) }}
//将R文件打成Jar包放入libs目录task embedRClass(type: org.gradle.jvm.tasks.Jar, dependsOn: collectRClass) { ... baseName "EmbedR" destinationDir file("$bundle_release_dir/libs") from base_r2x_dir}
解决完R文件的难题后,我们就基本完成了AAR的合并工作,但是在实际业务中,会遇到另一个棘手的问题:Support库兼容问题。上面已经分析过,一个库的R文件中会包含它依赖的所有子模块的资源文件(还记得原因么),假如我们的模块依赖了Support库(实际业务中很常见,比如用到了v4
的Fragment
或者RecyclerView
),那么R文件或R.txt中就会包含Support库内所有资源文件的信息,而当模块被接入后,在App的构建流程中,会根据最终的Support库版本(App依赖的Support库版本不可知)对各个R.txt
里的内容做过滤,只保留App工程中确实存在的资源文件,生成最终的R文件(源代码见com.android.builder.symbols.RGeneration
)。
举个例子,假如模块使用的A版本的Support库中有资源文件res1,而接入方App使用了更高版本的Support库中没有res1这个资源,那么App构建生成的R文件中将没有res1
这个资源索引,可是我们打入AAR中的R文件还保留着对res1的符号引用,结果就是在运行时类初始化失败(R.class的错误):
public final class R { public static final class string { //这里的com.main.library.R.string.res1被过滤掉不再存在,符号引用失效 public static int res1 = com.main.library.R.string.res1; }}
怎么办呢?第一反应是保证support库版本一致(必须精确到小版本号),即针对每个接入方构建出跟其Support库一致的产物,这就带来了很多隐藏成本(还需要手动做R.txt的过滤),更何况假如接入方某天更新了Support库版本,直接就Runtime Crash了,这属于对接事故,显然不能接受。那么,应该怎么做呢?其实很简单:禁止Support库资源写入R.txt即可(其实官方也明确提示过不要自己使用Support库里的资源),还记得R.txt是根据什么生成的么?
没错,是build/intermediates/res/merged/release
目录下的资源合集,而这些文件又是根据遍历依赖合并进来的,假如我们能在合并时过滤掉Support库的依赖项,就在源头上过滤掉了Support库资源。所以我们只需要对合并Resources的Task稍做手脚:
task filterMergeResource < def oldInputResourceSet = task_mergeResources.inputResourceSets List newInputResourceSet = new ArrayList(oldInputResourceSet) newInputResourceSet.removeAll {//过滤com.android.support包名下的依赖,避免support库资源打入R.txt (null != it.libraryName) && (it.libraryName.contains("com.android.support")) } task_mergeResources.conventionMapping.map("inputResourceSets") { newInputResourceSet }}
总结
最终我们插入了以上几个自定义任务到不同的构建节点中,完成了合并AAR的构建改造,但仍然有拓展空间,比如支持buildType和productFlavor,有兴趣的同学可以自己尝试下(其实就是找到对应的build目录)。
--------- END ----------
Android领域数一数二的圈子,给自己投资365天的学习吧!
想了解详情可以看这篇文章:
今天,我需要你的支持!
你好,我是刘望舒,十年经验的资深架构师,著有两本业界知名的技术畅销书,多个知名技术大会的特邀演讲嘉宾。
如果你喜欢我的文章,就给公众号加个星标吧,方便阅读。
在看也是一种认可
android aar保存图片文件异常_我去!合并AAR时踩坑了!相关推荐
- python合并excel文件关键字_使用 Python 合并多个格式一致的 Excel 文件,Excel 表格...
一 问题描述 最近朋友在工作中遇到这样一个问题,她每天都要处理如下一批 Excel 表格:每个表格的都只有一个 sheet,表格的前两行为表格标题及表头,表格的最后一行是相关人员签字.最终目标是将每个 ...
- 小程序统一服务消息_[miniblog]小程序订阅消息踩坑记
有阵子没有更新我的mini-blog了,这次把推送消息那块做了些改动,小程序的模板消息即将废弃,订阅消息终于来了. 关于订阅消息 订阅消息分为一次性订阅和长期订阅,长期订阅就不说啦,不是个人号可以染指 ...
- Android之通过文件绝对路径获取音视频的时长和视频的缩略图
1 需求 遍历一个文件夹,需要获取音视频的时长和视频的第一帧图像 2 关键代码实现 获取本地音视频的时长(这里计算出来的是秒为单位),如果文件不是音视频,下面的函数会发生异常,也就是返回0,我们除了通 ...
- c盘java文件误删_电脑清理C盘时误删重要文件如何恢复
我们都知道C盘是电脑的系统盘,储存很多重要的文件.windows系统在下载软件的时候,如果不更改存放位置,系统会默认放在C盘中,时间久了堆积大量文件,系统运行速度变慢.定期清理C盘文件可以加快运行速度 ...
- tkinter回调异常_使用matplotlib保存动画时Tkinter回调出现异常
我在问这个问题时有点犹豫,因为似乎有很多"Tkinter回调异常"的问题,但我找不到一个适合我这里的问题.在 我试图用matplotlib和ffmpeg保存MP4动画(渗透模拟). ...
- python 写入文件编码_使用Python写入文本文件时的编码问题
我正在编写一个程序,用一个简短的python脚本"手动"安排一个csv文件,使其成为正确的json语法.从输入文件中,我使用readlines()将文件格式化为一个行列表,然后将其 ...
- java 实例化异常_如何处理实例化类对象时发生的异常
java version "1.7.0_45" 你好 我正在构造函数中初始化类方法.但是,新URL(uploadUrl)将在构造函数中引发异常.因此,如果发生这种情况,用户应该无法 ...
- g++ linux 编译开栈_方舟编译器编译hello world踩坑全记录
闲来无事,看到方舟编译器完整开源,于是打算拿来试着编译一个东西来,接下来把踩过的一些坑记录一下. 参考文档 方舟编译器的官网是 OpenArkCompilerwww.openarkcompiler. ...
- 随笔:说说第一次在android中嵌入非全屏显示的unity游戏时的坑之——界面切换时出现延迟/卡顿/花屏等现象解决方法
One 最近对接了个unity3D做的小游戏到android项目中:游戏嵌入项目的界面且非全屏显示,项目几经波折,到我手上的时候,已经采用了在同一个activity中用两个View来分别显示andro ...
最新文章
- 大话风险投资的风险-不只是独角戏(上)
- css深入理解之overflow
- 二叉查找树BST----java实现
- 中国网建SMS短信接口调用(java发送短信)
- P2634 [国家集训队]聪聪可可(树上启发式合并)
- java 反射创建对象并赋值_[原创] Java JDBC连接数据库,反射创建实体类对象并赋值数据库行记录(支持存储过程)...
- 从汇编代码的角度观察switch与if...else,乘除与移位的差别
- 2021人工智能竞赛白皮书:1000场竞赛的深度分析
- serversocket 返回浏览器图片_深入理解浏览器的缓存机制
- 【DIOCP开源项目】实际应用案例
- 拓端tecdat|如何用R语言绘制生成正态分布图表
- UEFI学习 (一) ——下载与编译
- 解决 MDK 5 无法生成 .axf 文件的问题
- 计算机桌面音量键在哪,电脑音量调节快捷键_电脑音量快捷键设置
- 成功解决Cannot uninstall 'pywin32'. It is a distutils installed project and thus we cannot accurately de
- 智能门锁电路图_智能门锁结构拆解,我们一起来看看
- 系统聚类算法并绘制谱系图
- Talk to AI,揭秘背后的语音识别数据
- FZU 2139 久违的月赛之二
- windows下载安装配置Geany