新建Android Studio项目安装APK后设备未生成lib文件夹的缺失步骤排查
提问内容
目标
我希望安装APK时,APK内置的原生库能在设备的固定路径下被直接访问到。此前我在旧项目上遇到过同类问题,这次为了减少未知变量、简化问题定位流程,特意从零新建了一个完全干净的测试项目。
操作步骤
我使用的开发环境是Android Studio 4.0.1,完整操作流程如下:
- 新建Android Studio项目
- 选择Native C++项目模板
- 项目命名为
test - 开发语言选择Java
- 保持默认NDK工具链配置
- 执行
Build -> Make Project完成全量构建
构建完成后我已验证,生成的app-debug.apk内部确实包含lib目录,目录下拆分了多个ABI子文件夹,每个子文件夹内都有按照默认CMake规则构建出的libnative-lib.so文件。
我原本的预期是,安装完APK后可以直接在设备上访问到这个.so文件——毕竟在更复杂的正式项目中,我需要把自行编译的.so文件放到APK沙盒外的可访问位置,供其他模块调用。
但实际安装完成后,执行以下命令的结果和预期完全不符:
c:\Users\xxx\AndroidStudioProjects\test>adb install app\build\outputs\apk\debug\app-debug.apk Performing Streamed Install Success c:\Users\xxx\AndroidStudioProjects\test>adb shell ls /data/data/com.example.test cache code_cache
也就是查询应用私有沙盒根目录时,只能看到默认生成的cache和code_cache文件夹,完全找不到预期的lib相关目录。
已尝试的无效修改
以下所有调整操作,都没有让/data/data/com.example.test目录下出现预期的原生库文件:
- 在
gradle.properties中添加配置项android.bundle.enableUncompressedNativeLibs=false - 在模块级
build.gradle中添加如下sourceSets配置,未产生任何效果:android { ... sourceSets.main { jniLibs.srcDirs = ['libs'] jni.srcDirs = [] } } - 在
CMakeLists.txt中添加路径配置set(distribution_DIR ${CMAKE_SOURCE_DIR}/libs)
解答
你看不到对应文件的原因非常明确,按以下排查逻辑即可解决问题:
首先修正查询路径
即使系统正常解压了APK内的原生库,也不会把.so文件直接放在应用沙盒的根目录下,而是统一放到沙盒下的lib子目录中,完整路径结构为/data/data/com.example.test/lib/<abi>/libxxx.so。
你可以现在直接执行adb shell ls /data/data/com.example.test/lib验证,大概率已经能看到对应ABI的子目录和.so文件。调整系统原生库解压规则
从Android 10(API 29)开始,原生库是否会被解压到沙盒目录的最高优先级配置,是*AndroidManifest.xml中<application>标签的android:extractNativeLibs属性*。这个属性默认值为false,也就是系统会直接从APK压缩包内内存加载.so文件,完全不会把文件解压到沙盒磁盘上——这也是你之前配置了Gradle开关却没有效果的根本原因。
另外,你之前尝试添加的sourceSets配置、CMake路径配置,本质上都是构建阶段控制so文件打包来源的规则,既然已经确认APK内已经包含了目标so文件,这些配置自然不会对安装后的解压流程产生任何影响,自然达不到预期效果。
让配置完全生效的步骤
- 在
AndroidManifest.xml的<application>标签中,显式添加属性android:extractNativeLibs="true",强制系统将APK内的.so文件解压到沙盒的lib子目录中 - 确认
android.bundle.enableUncompressedNativeLibs=false配置写在项目根目录的gradle.properties文件中,不要写在模块目录的配置文件下,避免配置不生效 - 完全卸载设备上已安装的测试应用,重新执行构建、安装流程,再通过
adb shell ls /data/data/com.example.test/lib验证即可看到解压后的.so文件
补充提示:上述沙盒内的
lib目录是应用私有权限目录,其他应用默认无法访问。如果你的场景需要把.so文件放到跨应用可访问的公共位置,需要在应用启动时主动将沙盒内的.so文件拷贝到外部公共存储目录,不要依赖系统默认的解压路径。
内容的提问来源于stack exchange,提问作者Lolo

