Android-So-Handler

减包工具集合 , 通过处理so库实现减包

特点如下:

1. 支持APK中所有通过System.Load/LoadLibrary加载的So库文件（包含Maven、aar等方式引入三方库与源码中的so文件）进行处理。
2. 支持7z压缩与云端下发
3. 对项目代码侵入少，如果只是压缩so库，只需一行初始化AssetsSoLoadBy7zFileManager.init(v.getContext());即可。
4. 云端下发so库需要在init中传入NeedDownloadSoistener自行下载，并在下载后调用SoFileInfo#insertOrUpdateCache(saveLibsDir,File)插入缓存即可，需要在加载前插入缓存

数据对比:

仅仅在加载时通过记录的MD5判断是否存在，不存在解压，存在则跳过直接加载。 这里通过压缩时记录的MD5判断是否需要解压更新不依赖apk版本减少解压次数。

apk包中所占大小: apk属于zip压缩 所以apk包中已经为zip压缩后大小

7z极限压缩大小: 7z极限压缩大小是执行7z a xxx.7z libxxx.so -t7z -mx=9 -m0=LZMA2 -ms=10m -mf=on -mhc=on -mmt=on -mhcf 压缩后大小

解压后实际大小: 指so文件实际大小,AndroidStudio中文件大小

解压耗时(毫秒): 统计手机为谷歌Pixel 2XL 骁龙835处理器

接入方式如下:

ps:配置较多全可走默认 ~_ ~!

1. 根build.gradle中加入

buildscript {
    repositories {
        maven { url "https://raw.githubusercontent.com/IMFWorks/Android-So-Handler/master/maven" }
    }
}
allprojects {
    repositories {
      maven { url "https://raw.githubusercontent.com/IMFWorks/Android-So-Handler/master/maven" }
    }
}

2. 复制工程下so-file-config.gradle到工程根目录
3. 工程根目录gradle.properties中添加SO_PLUGIN_VERSION=0.0.6 build.gradle中添加classpath "com.imf.so:load-hook-plugin:${SO_PLUGIN_VERSION}"和classpath "com.imf.so:file-plugin:${SO_PLUGIN_VERSION}"
4. app的build.gradle中添加apply from: "${rootDir}/so-file-config.gradle"
5. 在Application中调用AssetsSoLoadBy7zFileManager.init(v.getContext());初始化,重载方法支持传入NeedDownloadSoListener完成云端所需要so库下载,下载后使用SoFileInfo#insertOrUpdateCache(saveLibsDir,File)插入缓存中
6. 修改根目录中so-file-config.gradle进行压缩删减库配置主要修改deleteSoLibs与compressSo2AssetsLibs如下:

//指定编辑阶段要删除的so库
deleteSoLibs = []
//指定至assets中的so库
compressSo2AssetsLibs = []

其他配置请参考注释

插件介绍

一、 SoLoadHookPlugin插件

1. 通过Hook System.loadLibrary 与 System.load实现加载转发具体步骤如下:

   • 通过ASM框架对Hook目标类进行字节码修改具体为 System.loadLibrary 与 System.load修改成SoLoadHook.loadLibrary与SoLoadHook.load
   • SoLoadHook可设置SoLoadProxy完成对外代理

   SoLoadHook有默认实现只是调用System.loadLibrary 与 System.load

2. 具体接入步骤如下:

• gradle配置

//build.gradle中只加入
classpath "com.imf.so:load-hook-plugin:${SO_PLUGIN_VERSION}" 
//app.gradle中只配置
apply plugin: 'SoLoadHookPlugin'
SoLoadHookConfig {
		//是否跳过R文件与BuildConfig
		isSkipRAndBuildConfig = true
		//设置跳过的包名,跳过的包不去hook 修改后请先clean
		excludePackage = ['com.imf.test.']
}
dependencies {
  implementation "com.imf.so:load-hook:${SO_PLUGIN_VERSION}"
}

• java代码实现SoLoadProxy完成加载

public interface SoLoadProxy {
    void loadLibrary(String libName);

    void load(String filename);
}
SoLoadHook.setSoLoadProxy(new XXXSoLoadProxy())

实现SoLoadProxy类后不会被修改System.loadLibrary与System.load字节码 如果不想在指定包名下修改 在excludePackage中配置报名 如果不想在指定类或方法下被修改字节码,请添加注解@KeepSystemLoadLib

二、SoFileTransformPlugin与SoFileAttachMergeTaskPlugin插件依赖SoLoadHookPlugin

SoFileTransformPlugin与SoFileAttachMergeTaskPlugin功能一样只是编辑阶段插入口不同 根据com.android.tools.build:gradle:x.x.x中版本号不同选择使用哪个 3.4.0版本及以下使用SoFileTransformPlugin 3.5.0 - 3.6.0版本使用SoFileAttachMergeTaskPlugin 其他版本请自行尝试,如果都失败提交issues我这边进行适配 已知问题最新版本4.1.0中添加了compressed_assets机制导致无法把压缩后的so文件放入asstes中,这个空闲时间阅读下4.1.0源码后适配 也欢迎大家push提交解决

1. 通过实现transform或在mergeNativeLibs中添加Action的方式,对so库进行7z压缩(利用压缩差实现压缩apk),压缩后放入asstes下的jniLib
2. 根据压缩或删除so情况生成info.json
3. 运行时进行解压加载 so

1. so库依赖拷贝了ReLinker中解析代码
2. 解压部分微调自AndroidUn7z

接入方式参考顶部最开始部分

三、TODO

1. 尝试对比压缩工具 zstd 与 7z
2. 兼容facebook/SoLoader库解压加载