📦 无法安装 APK
← 返回问题清单症状:adb install 报错(如 INSTALL_FAILED_… / 需要 USB 安装授权);或手机端弹「不允许 USB 安装」。
1读完整报错再动手
$ adb install -r app.apk
INSTALL_FAILED_UPDATE_INCOMPATIBLE
报错码直接指向原因,别盲试。常见对照见下几步。
2小米:「USB 安装」没开
报错含「USB installation」或手机弹「出于安全考虑,已禁止 USB 安装」:到开发者选项打开「USB 安装」(需 SIM 卡 + 小米账号 + 联网)。
↔ 左右滑动,查看完整示意图
3签名 / 版本冲突
- INSTALL_FAILED_UPDATE_INCOMPATIBLE:已装版本签名不同 → 先卸载
adb uninstall 包名再装; - INSTALL_FAILED_VERSION_DOWNGRADE:装的是旧版 → 加
-d允许降级或先卸载; - INSTALL_PARSE_FAILED_NO_CERTIFICATES:APK 未签名或损坏,重新打包。
4空间不足 / 路径问题
- INSTALL_FAILED_INSUFFICIENT_STORAGE:清理手机空间;
- Windows 路径含中文/空格报错 → 给路径加英文引号,或先把 APK 复制到
D:\tmp\; - OPPO/vivo 等机型如提示安装被拦截,检查其开发者选项内类似的安装许可开关(名称随系统版本变化,以手机提示为准)。
5验证安装结果
$ adb install -r app.apk
Success
$ adb shell pm list packages | findstr yourapp
🧭 常规手段已用尽
特定 APK 始终失败:换回手机上直接点击安装验证是否 APK 本身问题;企业设备可能被 MDM 禁止侧载。开发者建议用 Android Studio 的 Run 部署获得更详细日志。