源作者:溪流涌动
安装程序并未成功地运行完成是什么原因安装应用的基本命令格式是:
adb install [-l] [-r] [-t] [-s] [-d] [-g]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!
已安装该应用且签名不一致
先卸载设备上的该应用,再安装