最新 2.0 版本支持 Android Gradle Plugin 8.x，其他版本不做支持保证，理论上 agp 7.2 以上是可以兼容的了解更多。
新版变化，参考 releases。
AGP7.x 及以下请切换到 main-agp7.x 分支，原 README 请阅读 main-agp7.x/README.md。
- 支持 APK 中所有通过
System.Load/LoadLibrary加载的 So 库文件（包含 Maven、aar 等方式引入三方库与源码中的 so 文件）进行处理。 - 支持 7z 压缩与云端下发
- 对项目代码侵入少，如果只是压缩 so
库，只需一行初始化
AssetsSoLoadBy7zFileManager.init(v.getContext());即可。 - 云端下发 so 库需要在
init中传入NeedDownloadSoistener自行下载，并在下载后调用SoFileInfo#insertOrUpdateCache(saveLibsDir,File)插入缓存即可，** 需要在加载前插入缓存 **
工件包发布在 Jitpack
目前插件未发布到 Gradle 官方 Gradle Plugin Portal，所以，需要通过以下方式引入，暂时不能使用 plugins 块的方式。
此处 maven("https://jitpack.io") 也可添加到 settings.gradle 的 dependencyResolutionManagement 模块中。参考 settings.gradle.kts
buildscript {
val userSoPlugin by extra
val SO_PLUGIN_VERSION by extra
repositories {
maven("https://jitpack.io")
}
dependencies {
if (userSoPlugin) {
classpath("com.github.mcxinyu.Android-So-Handler:load-hook-plugin:${SO_PLUGIN_VERSION}")
classpath("com.github.mcxinyu.Android-So-Handler:file-plugin:${SO_PLUGIN_VERSION}")
}
}
}plugins {
// ...
id("com.imf.plugin.so.ApkSoFileAdjustPlugin")
id("com.imf.plugin.so.SoLoadHookPlugin")
}
dependencies {
val SO_PLUGIN_VERSION by project
listOf(
"com.github.mcxinyu.Android-So-Handler:load-hook:$SO_PLUGIN_VERSION",
"com.github.mcxinyu.Android-So-Handler:load-assets-7z:$SO_PLUGIN_VERSION"
).forEach(::implementation)
}参考 so-file-config.gradle groovy 写法。
或者 build.gradle.kts kts 中使用有条件的动态语法。
下面是 kts 的常规写法，与 groovy 类似：
SoFileConfig {
/**
* 总开关配置 不配置时根据 compressSo2AssetsLibs 与 deleteSoLibs 是否为空自动开启关闭 配置 true 强制开启 false 强制关闭
*/
// enable = false
// 设置 debug 下不删除与压缩 so 库
excludeBuildTypes = setOf("debug")
forceNeededRetainAllDependencies = true
backupApk = true
useApktool = true
// 设置要删除的 so 库
deleteSoLibs = emptySet()
// 移除 so 时回调，这里可以做上传云端的逻辑
onDeleteSo = { file, md5 ->
// 可以返回一个 so 文件的下载链接，可通过 md5 判断缓存读取链接，如果没有则上传云端并返回链接
// 作者在实际项目中是在此处将 so 压缩后上传云端，在 NeedDownloadSoListener 中下载，调用 insertOrUpdateCache 前解压。
}
// 设置要压缩的库 注意 libun7zip.so 为 7z 解压库不可压缩
compressSo2AssetsLibs = setOf()
// 排除依赖
excludeDependencies = setOf(
"libun7zip.so",
"libmmkv.so",
)
/**
* 配置自定义依赖 用于解决 a.so 并未声明依赖 b.so 并且内部通过 dlopen 打开 b.so 或者反射 System.loadLibrary 等跳过 hook 加载 so
* 库等场景
*/
customDependencies = mapOf(
// "libflutter.so" to listOf("libapp.so")
)
}
SoLoadHookConfig {
// 默认启用的
enable = true
// 是否跳过 R 文件与 BuildConfig
skipRAndBuildConfig = true
// 设置跳过的包名, 跳过的包不去 hook 修改后请先 clean
excludePackage = setOf(
"com.imf.so"
)
}其他注意事项请阅读原说明