作者
大家好,我叫小嘉; 本人20年本科毕业于广东工业大学,于2020年6月加入37手游安卓团队;目前工作是国内游戏发行安卓相关开发。
问题背景
日常切包业务中,有的渠道 sdk 已经包含 kotlin 相关代码。由于之前没有做 kotlin 的适配,导致在进行切包后的游戏包进行闪退。
日常切包业务如图:
观察正常demo 包下面的资源情况:
对比了切包后的游戏包资源和正常 demo 包的资源,发现少了 kotlin 目录,而且 META-INF目录下也少了很多资源。
文件根据目录和后缀分为四种:
.kotlin_module 位于 META-INF 目录下
.version 文件位于 META-INF 目录下
.kotlin_metadata 位于 kotlin 目录下
.kotlin_builtins 位于 kotlin 目录下
kotlin_module 文件
本质上是为了优化顶级函数/变量定义时潜在的包名冲突,通过独立的kotlin_module实现快速查找。另一个是反射使用。
例如在kotlin中可以书写如下代码,不指定类而直接创建一个包名顶级的函数
编译后,与Java中如下写法异曲同工
针对每个lib/module生成kotlin_module文件,该文件的维度是以lib库为粒度,并不是一个类一个文件
如果再创建一个libkotlin,则kotlin_module会再增加一个
除了开发者的kotlin模块新增的文件,其他都是kotlin库产生的
在Demo测试中,删除并没有产生任何问题。这个配置是作用于编译期,告诉编译器如何正确生成class代码的,运行期间并不会使用到,APK导包过程时可以删除。如果有使用kotlin reflect可能会出错。
kotlin_metadata文件
二进制文件,从反编译数据看,kotlin类经过编译后,带上了一个MetaData的注解,并且配置信息非常多,这也直接导致kotlin编写的代码生成的class文件,比java编写的代码生成的class要大。
编译后class
这些元数据文件,在Demo中被删除后程序正常运行,说明运行期间也没有用上,但是不排除其他反射调用会涉及。
kotlin_builtins文件
二进制文件,kotlin基础库的所支持的类库新,如果删除,反射实例化运行时就会直接报错。
.verison文件
纯文本文件,内部一般是一个版本号。
将demo 包体用 apktool 反编译:
.kotlin_module 和 .version 在 original/META-INF 目录下
.kotlin_metadata 和 .kotlin_builtins 位于kotlin目录下
由于切包业务是在中间层做的,所以最好做法是这些相关文件都保存
综上所述kotlin 切包适配步骤:
1、反编译生成渠道资源时,保留original目录和META-INF目录
2、合并渠道资源时,合并original和META-INF目录
3、回编译前删除掉META-INF中的签名文件
4、回编译时 java -jar apktool.jar -c b xxx。新增-c参数 -c 参数的意思是保存 original 目录
5、保存 kotlin 目录
详细步骤:
- 保留 kotlin 目录
apktool 反编译后会保存的目录:kotlin 目录是会存在的
这个2.4.1版本 apktool 里面保留的正常目录,所以假如反编译存在 kotlin 目录需要进行保留。
- 保留 orignal 目录
original 目录下保存的内容:
AndroidManifest.xml 和 META-INF(签名文件)
此处只需要保存 META-INF 目录。
注:假如 Original 目录下存在 AndroidManifest.xml 的话,在会编译的时候便会以此清单文件来进行回编译,而不会以直接目录下的AndroidManifest.xml 来回编译
-
保留 META-NIF目录
-
处理 签名文件(放在 Original/META-INF目录里面,所以需要删除签名文件,重新生成,如果不删除 RSA / MF/ SF 签名文件,此时是回编译前的签名文件,因为前面已经改过 apk 包文件, 会回编译报错)
build/apk 文件夹是用来生成 apk 的目录,内容如下: