安装应用的基本命令格式是:
adb install [-l] [-r] [-t] [-s] [-d] [-g] <APK-file>
adb install 后面可以跟一些可选参数来控制安装 APK 的行为,可用参数及含义如下:
参数 含义
-l 将应用安装到保护目录 /mnt/asec
-r 允许覆盖安装
-t 允许安装 Androidmanifest.xml 里 application 指定 android:testOnly=“true” 的应用
-s 将应用安装到 sdcard
-d 允许降级覆盖安装
-g 授予所有运行时权限
运行命令后可以看到输出内容,包含安装进度和状态,安装状态如下:
Success:代表安装成功。 | |||
Failure:代表安装失败。APK 安装失败的情况有很多,Failure状态之后有安装失败输出代码。常见安装失败输出代码、含义及可能的解决办法如下: | |||
序号 | 输出代码 | 含义 | 解决办法 |
1 | INSTALL_FAILED_ALREADY_EXISTS | 应用已经存在,或卸载了但没卸载干净 | adb install 时使用 -r 参数,或者先 adb uninstall 再安装 |
2 | INSTALL_FAILED_INVALID_APK | 无效的 APK 文件 | |
3 | INSTALL_FAILED_INVALID_URI | 无效的 APK 文件名 | 确保 APK 文件名里无中文 |
4 | INSTALL_FAILED_INSUFFICIENT_STORAGE | 空间不足 | 清理空间 |
5 | INSTALL_FAILED_DUPLICATE_PACKAGE | 已经存在同名程序 | |
6 | INSTALL_FAILED_NO_SHARED_USER | 请求的共享用户不存在 | |
7 | INSTALL_FAILED_UPDATE_INCOMPATIBLE | 以前安装过同名应用,但卸载时数据没有移除;或者已安装该应用,但签名不一致 | 先 adb uninstall 再安装 |
8 | INSTALL_FAILED_SHARED_USER_INCOMPATIBLE | 请求的共享用户存在但签名不一致 | |
9 | INSTALL_FAILED_MISSING_SHARED_LIBRARY | 安装包使用了设备上不可用的共享库 | |
10 | INSTALL_FAILED_REPLACE_COULDNT_DELETE | 替换时无法删除 | |
11 | INSTALL_FAILED_DEXOPT | dex 优化验证失败或空间不足 | |
12 | INSTALL_FAILED_OLDER_SDK | 设备系统版本低于应用要求 | |
13 | INSTALL_FAILED_CONFLICTING_PROVIDER | 设备里已经存在与应用里同名的 content provider | |
14 | INSTALL_FAILED_NEWER_SDK | 设备系统版本高于应用要求 | |
15 | INSTALL_FAILED_TEST_ONLY | 应用是 test-only 的,但安装时没有指定 -t 参数 | |
16 | INSTALL_FAILED_CPU_ABI_INCOMPATIBLE | 包含不兼容设备 CPU 应用程序二进制接口的 native code | |
17 | INSTALL_FAILED_MISSING_FEATURE | 应用使用了设备不可用的功能 | |
18 | INSTALL_FAILED_CONTAINER_ERROR | 1. sdcard 访问失败;2. 应用签名与 ROM 签名一致,被当作内置应用。 | 1. 确认 sdcard 可用,或者安装到内置存储;2. 打包时不与 ROM 使用相同签名。 |
19 | INSTALL_FAILED_INVALID_INSTALL_LOCATION | 1. 不能安装到指定位置;2. 应用签名与 ROM 签名一致,被当作内置应用。 | 1. 切换安装位置,添加或删除 -s 参数;2. 打包时不与 ROM 使用相同签名。 |
20 | INSTALL_FAILED_MEDIA_UNAVAILABLE | 安装位置不可用 | 一般为 sdcard,确认 sdcard 可用或安装到内置存储 |
21 | INSTALL_FAILED_VERIFICATION_TIMEOUT | 验证安装包超时 | |
22 | INSTALL_FAILED_VERIFICATION_FAILURE | 验证安装包失败 | |
23 | INSTALL_FAILED_PACKAGE_CHANGED | 应用与调用程序期望的不一致 | |
24 | INSTALL_FAILED_UID_CHANGED | 以前安装过该应用,与本次分配的 UID 不一致 | 清除以前安装过的残留文件 |
25 | INSTALL_FAILED_VERSION_DOWNGRADE | 已经安装了该应用更高版本 | 使用 -d 参数 |
26 | INSTALL_FAILED_PERMISSION_MODEL_DOWNGRADE | 已安装 target SDK 支持运行时权限的同名应用,要安装的版本不支持运行时权限 | |
27 | INSTALL_PARSE_FAILED_NOT_APK | 指定路径不是文件,或不是以 .apk 结尾 | |
28 | INSTALL_PARSE_FAILED_BAD_MANIFEST | 无法解析的 AndroidManifest.xml 文件 | |
29 | INSTALL_PARSE_FAILED_UNEXPECTED_Exception | 解析器遇到异常 | |
30 | INSTALL_PARSE_FAILED_NO_CERTIFICATES | 安装包没有签名 | |
31 | INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES | 已安装该应用,且签名与 APK 文件不一致 | 先卸载设备上的该应用,再安装 |
32 | INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING | 解析 APK 文件时遇到 CertificateEncodingException | |
33 | INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME | manifest 文件里没有或者使用了无效的包名 | |
34 | INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID | manifest 文件里指定了无效的共享用户 ID | |
35 | INSTALL_PARSE_FAILED_MANIFEST_MALFORMED | 解析 manifest 文件时遇到结构性错误 | |
36 | INSTALL_PARSE_FAILED_MANIFEST_EMPTY | 在 manifest 文件里找不到找可操作标签(instrumentation 或 application) | |
37 | INSTALL_FAILED_INTERNAL_ERROR | 因系统问题安装失败 | |
38 | INSTALL_FAILED_USER_RESTRICTED | 用户被限制安装应用 | |
39 | INSTALL_FAILED_DUPLICATE_PERMISSION | 应用尝试定义一个已经存在的权限名称 | |
40 | INSTALL_FAILED_NO_MATCHING_ABIS | 应用包含设备的应用程序二进制接口不支持的 native code | |
41 | INSTALL_CANCELED_BY_USER | 应用安装需要在设备上确认,但未操作设备或点了取消 | 在设备上同意安装 |
42 | INSTALL_FAILED_ACWF_INCOMPATIBLE | 应用程序与设备不兼容 | |
43 | INSTALL_FAILED_TEST_ONLY | APK 文件是使用 Android Studio 直接 RUN 编译出来的文件 | 通过 Gradle 的 assembleDebug 或 assembleRelease 重新编译,或者 Generate Signed APK |
44 | does not contain AndroidManifest.xml | 无效的 APK 文件 | |
45 | is not a valid zip file | 无效的 APK 文件 | |
46 | Offline | 设备未连接成功 | 先将设备与 adb 连接成功 |
47 | unauthorized | 设备未授权允许调试 | |
48 | error: device not found | 没有连接成功的设备 | 先将设备与 adb 连接成功 |
49 | protocol failure | 设备已断开连接 | 先将设备与 adb 连接成功 |
50 | Unknown option: -s | Android 2.2 以下不支持安装到 sdcard | 不使用 -s 参数 |
51 | No space left on device | 空间不足 | 清理空间 |
52 | Permission denied … sdcard … | sdcard 不可用 | |
53 | signatures do not match the previously installed version; ignoring! | 已安装该应用且签名不一致 | 先卸载设备上的该应用,再安装 |