UniApp 应用未安装通常由以下原因导致,可按步骤排查:
-
安装包签名问题
- 不同签名的 APK 无法覆盖安装(如调试版替换正式版)。
- 解决:卸载旧版本再安装,或确保签名一致。
-
CPU 架构不兼容
- 部分设备(如 ARM64)可能无法运行仅包含
armeabi-v7a 的安装包。
- 解决:在
manifest.json 中配置 App 模块支持的 CPU 类型,或使用官方云打包自动适配。
-
安装包损坏
- 网络传输中断或文件下载不完整。
- 解决:重新下载或生成安装包,检查 MD5 是否匹配。
-
系统权限限制
- 安卓设备禁止“未知来源应用”安装,或开启了“安全扫描”拦截。
- 解决:在系统设置中允许未知来源安装,临时关闭安全扫描。
-
存储空间不足
- 设备剩余空间小于应用所需容量。
- 解决:清理存储空间后重试。
-
UniApp 特定配置错误
manifest.json 中应用 ID(AppID)或版本号配置异常,或模块冲突。
- 解决:检查配置,删除冲突原生模块(如多个推送模块)。
-
Android 系统版本兼容性
- 最低 SDK 版本设置过高,或使用了不兼容的 API。
- 解决:调整
manifest.json 中 minSdkVersion,或更新 UniApp SDK。
建议操作流程:
- 换设备测试安装包,确认是否普遍问题。
- 使用 HBuilderX 重新打包,选择默认配置。
- 查看安装失败时的具体错误日志(安卓可通过
adb logcat 抓取)。
若问题持续,提供详细设备型号、安卓版本及打包方式(本地/云打包)以便进一步排查。