Android 16KB对齐兼容问题：如何定位.so文件所属依赖及解决方法

1. 定位问题.so文件所属的依赖 #

• 用Gradle依赖树排查：执行./gradlew app:dependencies --configuration releaseRuntimeClasspath（根据你的构建变体换成debug），在输出结果里搜索目标.so文件名，关联对应的依赖。如果直接搜不到，就用下面的方法：
• 手动解包依赖AAR：本地Gradle仓库（默认路径~/.gradle/caches/modules-2/files-2.1/）里找到可疑的依赖AAR文件，解压后查看jni/目录是否包含问题.so。
• 批量脚本排查：写个shell脚本遍历本地仓库的所有AAR，自动检查是否包含目标.so，示例脚本：

#!/bin/bash
TARGET_SO="lib问题文件.so"
SEARCH_DIR=~/.gradle/caches/modules-2/files-2.1/
find "$SEARCH_DIR" -name "*.aar" -exec sh -c 'unzip -l "$1" | grep -q '"$TARGET_SO"' && echo "$1"' _ {} \;

• 如果你用Android Studio，也可以切换到Project Files视图，展开External Libraries逐个查看依赖的jni目录，但依赖多的话还是脚本更高效。

2. 不更新依赖时实现16KB对齐的方法 #

• 用NDK的repackelf工具手动修正：NDK自带的repackelf可以调整ELF文件的段对齐参数，命令为repackelf --align 16384 原.so文件 修正后.so文件（16KB等于16384字节）。把所有问题.so提取出来处理后，替换回APK对应的目录即可。
• 自定义Gradle任务自动处理：在app模块的build.gradle中添加任务，在打包前自动修正问题.so，示例代码：

task fixSoAlignment {
    doLast {
        def ndkDir = android.ndkDirectory
        // 根据你的系统替换，比如linux-x86_64、darwin-x86_64、windows-x86_64
        def os = "linux-x86_64"
        def repackelfPath = "${ndkDir}/toolchains/llvm/prebuilt/${os}/bin/repackelf"
        def soDir = file("${buildDir}/intermediates/merged_jni_libs/release/out/lib")
        // 替换成你的问题so文件名列表
        def targetSos = ["libaaa.so", "libbbb.so"]
        
        android.productFlavors.each { flavor ->
            android.splits.abi.each { abi ->
                targetSos.each { soName ->
                    def soPath = "${soDir}/${abi}/${soName}"
                    if (file(soPath).exists()) {
                        exec {
                            commandLine repackelfPath, "--align", "16384", soPath, soPath
                        }
                    }
                }
            }
        }
    }
}
// 让修正任务在打包前执行
preBuild.dependsOn fixSoAlignment

• 注意：手动修改.so可能引发未知问题，一定要全面测试相关功能。如果依赖的.so有签名校验，修改后会导致验证失败，这种情况只能换依赖或者联系作者更新。

内容的提问来源于stack exchange，提问作者RusArtM