You need to enable JavaScript to run this app. 新建Android Studio项目安装APK后设备未生成lib文件夹的缺失步骤排查
优惠活动
大模型
产品
解决方案
定价
更多

新建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)

解答

你看不到对应文件的原因非常明确,按以下排查逻辑即可解决问题:

  1. 首先修正查询路径
    即使系统正常解压了APK内的原生库,也不会把.so文件直接放在应用沙盒的根目录下,而是统一放到沙盒下的lib子目录中,完整路径结构为/data/data/com.example.test/lib/<abi>/libxxx.so。
    你可以现在直接执行adb shell ls /data/data/com.example.test/lib验证,大概率已经能看到对应ABI的子目录和.so文件。

  2. 调整系统原生库解压规则
    从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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 14:06:07