原文地址:Most complete ADB command manual
作者:larson
书接上文
应用程序管理
1.1、查看申请列表
查看应用程序列表的基本命令格式是
adb shell pm list packages [-f] [-d] [-e] [-s] [-3] [-i] [-u] [--user USER_ID] [FILTER]
即在 adb shell pm list packages 的基础上,可以增加一些参数来过滤查看不同的列表,支持的过滤参数如下:
参数 | 显示列表 |
---|---|
没有任何 | 所有应用程序 |
-F | 显示应用程序关联的 apk 文件 |
-d | 仅显示已禁用的应用程序 |
-e | 仅显示已启用的应用程序 |
-s | 仅显示系统应用 |
-3 | 仅显示第三方应用程序 |
-i | 显示应用程序的安装程序 |
-u | 包括未安装的应用程序 |
<FILTER> | 包名称包含<FILTER>字符串 |
1.2、所有应用程序
命令:
adb shell pm list packages
示例输出:
package:com.android.smoketest
package:com.example.android.livecubes
package:com.android.providers.telephony
package:com.google.android.googlequicksearchbox
package:com.android.providers.calendar
package:com.android.providers.media
package:com.android.protips
package:com.android.documentsui
package:com.android.gallery
package:com.android.externalstorage
...
// other packages here
...
1.3、系统应用程序
命令:
adb shell pm list packages -s
1.4、第三方使用
命令:
adb shell pm list packages -3
包名包含某个字符串的应用程序
例如,查看报名包含字符串mazhuang
的应用程序列表,命令:
adb shell pm list packages muzhuang
当然也可以用 grep 来过滤:
adb shell pm list packages | grep mazhuang
1.5、安装 APK
命令格式:
adb install [-lrtsdg] <path_to_apk>
范围: Adb install后面可以跟一些可选参数来控制安装 APK 的行为,可用的参数及其含义如下:
参数 | 意义 |
---|---|
-l | 将应用程序安装到受保护的目录 /mnt/asec |
-r | 允许覆盖安装 |
-t | 允许安装 android:testOnly=true AndroidManifest.xml 中 application 指定的应用程序 |
-s | 将应用程序安装到 SD 卡 |
-d | 允许降级以覆盖安装 |
-G | 授权所有运行时权限 |
运行命令后,如果看到类似下面的输出(状态为 Success),则表示安装成功:
[100%] /data/local/tmp/1.apk
pkg: /data/local/tmp/1.apk
Success
以上是最新版本v1.0.36的adb的输出,会显示推送apk文件到手机的进度百分比。
使用旧版本的 adb,输出如下:
12040 KB/s (22205609 bytes in 1.801s)
pkg: /data/local/tmp/SogouInput_android_v8.3_sweb.apk
Success
如果状态为 Failure,则表示安装失败,例如:
[100%] /data/local/tmp/map-20160831.apk
pkg: /data/local/tmp/map-20160831.apk
Failure [INSTALL_FAILED_ALREADY_EXISTS]
常见安装的故障输出代码、含义及可能的解决方法如下:
解析 APK 文件时
输出 | 意义 | 解决方案 |
---|---|---|
INSTALL_FAILED_ALREADY_EXISTS | 应用程序已存在,或已卸载但未卸载干净 | adb install ,使用-r 参数,或者adb uninstall <packagename> 先安装 |
INSTALL_FAILED_INVALID_APK | APK 文件无效 | |
INSTALL_FAILED_INVALID_URI | APK 文件名无效 | 确保APK文件名中没有中文 |
INSTALL_FAILED_INSUFFICIENT_STORAGE | 没有足够的空位 | 清理空间 |
INSTALL_FAILED_DUPLICATE_PACKAGE | 同名程序已存在 | |
INSTALL_FAILED_NO_SHARED_USER | 请求的共享用户不存在 | |
INSTALL_FAILED_UPDATE_INCOMPATIBLE | 同名应用曾经安装过,但卸载时未清除数据;或者应用曾经安装过,但签名不一致 | 首先adb uninstall <packagename> 然后安装 |
INSTALL_FAILED_SHARED_USER_INCOMPATIBLE | 请求的共享用户存在但签名不一致 | |
INSTALL_FAILED_MISSING_SHARED_LIBRARY | 安装包使用了设备上没有的共享库 | |
INSTALL_FAILED_REPLACE_COULDNT_DELETE | 替换时无法删除 | |
INSTALL_FAILED_DEXOPT | dex优化验证失败或空间不足 | |
INSTALL_FAILED_OLDER_SDK | 设备系统版本低于应用要求 | |
INSTALL_FAILED_CONFLICTING_PROVIDER | 设备中已存在与应用同名的内容提供程序 | |
INSTALL_FAILED_NEWER_SDK | 设备系统版本高于应用要求 | |
INSTALL_FAILED_TEST_ONLY | 应用程序仅供测试,但-t 安装时未指定参数 | |
INSTALL_FAILED_CPU_ABI_INCOMPATIBLE | 包含不兼容设备 CPU 应用程序二进制接口的本机代码 | |
INSTALL_FAILED_MISSING_FEATURE | 该应用程序使用了设备上不可用的功能 | |
INSTALL_FAILED_CONTAINER_ERROR | 1、sdcard访问失败; 2、应用签名与ROM签名一致,视为内置应用程序。 | 1.确认sdcard可用,或者安装到内置存储; 2.打包时不要使用和ROM相同的签名。 |
INSTALL_FAILED_INVALID_INSTALL_LOCATION | 1.无法安装到指定位置; 2.应用程序签名与ROM签名一致,被视为内置应用程序。 | 1.切换安装位置,增加或者删除参数-s ; 2.打包时不要使用和ROM相同的签名。 |
INSTALL_FAILED_MEDIA_UNAVAILABLE | 安装位置不可用 | 一般是sdcard,确认sdcard可用或者安装到内置存储 |
INSTALL_FAILED_VERIFICATION_TIMEOUT | 验证安装包超时 | |
INSTALL_FAILED_VERIFICATION_FAILURE | 验证安装包失败 | |
INSTALL_FAILED_PACKAGE_CHANGED | 应用程序与调用程序的期望不符 | |
INSTALL_FAILED_UID_CHANGED | 该应用之前安装过,与本次分配的UID不一致 | 清理以前安装的残留文件 |
INSTALL_FAILED_VERSION_DOWNGRADE | 已安装此应用的较新版本 | 使用-d 参数 |
INSTALL_FAILED_PERMISSION_MODEL_DOWNGRADE | 安装的目标 SDK 支持具有运行时权限的同名应用程序,而要安装的版本不支持运行时权限 | |
INSTALL_PARSE_FAILED_NOT_APK | 指定的路径不是文件或不是以.apk | |
安装解析失败_BAD_MANIFEST | 无法解析 AndroidManifest.xml 文件 | |
INSTALL_PARSE_FAILED_BAD_MANIFEST | 解析器遇到异常 | |
INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION | 安装包未签名 | |
INSTALL_PARSE_FAILED_NO_CERTIFICATES | 应用已安装,签名与APK文件不一致 | 先在设备上卸载该应用程序,然后安装 |
INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING | CertificateEncodingException | |
INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME | 清单文件中没有软件包名称或软件包名称无效 | |
INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID | 清单文件中指定了无效的共享用户 ID | |
INSTALL_PARSE_FAILED_MANIFEST_MALFORMED | 解析清单文件时遇到结构错误 | |
INSTALL_PARSE_FAILED_MANIFEST_EMPTY | 清单文件中找不到可操作标签(仪器或应用程序) | |
INSTALL_FAILED_INTERNAL_ERROR | 由于系统问题,安装失败 | |
INSTALL_FAILED_USER_RESTRICTED | 限制用户安装应用程序 | |
INSTALL_FAILED_DUPLICATE_PERMISSION | 应用程序尝试定义现有的权限名称 | |
INSTALL_FAILED_NO_MATCHING_ABIS | 该应用程序包含设备应用程序二进制接口不支持的本机代码 | |
INSTALL_CANCELED_BY_USER | 需要在设备上确认安装应用,但设备未进行操作或取消 | 同意在设备上安装 |
INSTALL_FAILED_ACWF_INCOMPATIBLE | 该应用程序与设备不兼容 | |
does not contain AndroidManifest.xml | APK 文件无效 | |
is not a valid zip file | APK 文件无效 | |
Offline | 设备未连接成功 | 首先将设备连接到adb成功 |
unauthorized | 该设备无权允许调试 | |
error: device not found | 没有成功连接设备 | 首先将设备连接到adb成功 |
protocol failure | 设备已断开连接 | 首先将设备连接到adb成功 |
Unknown option: -s | Android 2.2 不支持安装到 SD 卡 | 不要使用-s 参数 |
No space left on device | 没有足够的空位 | 清理空间 |
Permission denied ... sdcard ... | SD 卡不可用 | |
signatures do not match the previously installed version; ignoring! | 应用已安装,且签名不一致 | 先在设备上卸载该应用程序,然后安装 |
1.6、adb install 内部原理介绍
adb install 其实分三步完成:
- 将 apk 文件推送到/data/local/tmp。
- 调用 pm install 进行安装。
- 删除/data/local/tmp 下对应的 apk 文件
因此在有需要的时候,您也可以按照此步骤,一步一步手动执行安装过程。
1.7、卸载应用程序
命令:
adb uninstall [-k] <packagename>
<packagename>
表示应用的包名,-k 参数可选,表示卸载应用但是保留数据和缓存目录。
命令示例:
adb uninstall com.qihoo360.mobilesafe
意思是卸载 360 手机卫士。
1.8、清除应用程序数据和缓存
命令:
adb shell pm clear <packagename>
<packagename>
代表应用的包名,该命令的效果相当于在设置里的应用信息界面惦记“清除缓存”和“清除数据”。
命令示例:
adb shell pm clear com.qihoo360.mobilesafe
意思是清除 360 手机卫士的数据和缓存。
1.9、查看前台活动
命令:
adb shell dumpsys activity activities | grep mFocusedActivity
示例输出:
mFocusedActivity: ActivityRecord{8079d7e u0 com.cyanogenmod.trebuchet/com.android.launcher3.Launcher t42}
其中,com.cyanogenmod.trebuchet/com.android.launcher3.Launcher
是当前处于前台的 Activity。
1.10、查看正在运行的服务
命令:
adb shell dumpsys activity services [<packagename>]
该<packagename>
参数非必需,<packagename>
指定表示查看某个包名相关的 Services,不指定表示查看所有 Services。
<packagename>
不一定要给出完整的包名。例如你运行adb shell dumpsys activity services org.mazhuang
,那么包名org.mazhuang.demo1
、org.mazhuang.demo2
、org.mazhuang123
等相关服务都会被列出来。
1.11、查看应用程序详细信息
命令:
adb shell dumpsys package <packagename>
输出的内容包含了很多信息,包括AcrivityResolver Table
、RegisteredContentProviders
、package name
、userId
、安装后的文件资源代码的路径、版本信息、权限信息及授予状态、签名版本信息等。
<packagename>
代表应用程序包名。
示例输出:
Activity Resolver Table:
Non-Data Actions:
android.intent.action.MAIN:
5b4cba8 org.mazhuang.guanggoo/.SplashActivity filter 5ec9dcc
Action: "android.intent.action.MAIN"
Category: "android.intent.category.LAUNCHER"
AutoVerify=false
Registered ContentProviders:
org.mazhuang.guanggoo/com.tencent.bugly.beta.utils.BuglyFileProvider:
Provider{7a3c394 org.mazhuang.guanggoo/com.tencent.bugly.beta.utils.BuglyFileProvider}
ContentProvider Authorities:
[org.mazhuang.guanggoo.fileProvider]:
Provider{7a3c394 org.mazhuang.guanggoo/com.tencent.bugly.beta.utils.BuglyFileProvider}
applicationInfo=ApplicationInfo{7754242 org.mazhuang.guanggoo}
Key Set Manager:
[org.mazhuang.guanggoo]
Signing KeySets: 501
Packages:
Package [org.mazhuang.guanggoo] (c1d7f):
userId=10394
pkg=Package{55f714c org.mazhuang.guanggoo}
codePath=/data/app/org.mazhuang.guanggoo-2
resourcePath=/data/app/org.mazhuang.guanggoo-2
legacyNativeLibraryDir=/data/app/org.mazhuang.guanggoo-2/lib
primaryCpuAbi=null
secondaryCpuAbi=null
versionCode=74 minSdk=15 targetSdk=25
versionName=1.1.74
splits=[base]
apkSigningVersion=2
applicationInfo=ApplicationInfo{7754242 org.mazhuang.guanggoo}
flags=[ HAS_CODE ALLOW_CLEAR_USER_DATA ALLOW_BACKUP]
privateFlags=[ RESIZEABLE_ACTIVITIES]
dataDir=/data/user/0/org.mazhuang.guanggoo
supportsScreens=[small, medium, large, xlarge, resizeable, anyDensity]
timeStamp=2017-10-22 23:50:53
firstInstallTime=2017-10-22 23:50:25
lastUpdateTime=2017-10-22 23:50:55
installerPackageName=com.miui.packageinstaller
signatures=PackageSignatures{af09595 [53c7caa2]}
installPermissionsFixed=true installStatus=1
pkgFlags=[ HAS_CODE ALLOW_CLEAR_USER_DATA ALLOW_BACKUP]
requested permissions:
android.permission.READ_PHONE_STATE
android.permission.INTERNET
android.permission.ACCESS_NETWORK_STATE
android.permission.ACCESS_WIFI_STATE
android.permission.READ_LOGS
android.permission.WRITE_EXTERNAL_STORAGE
android.permission.READ_EXTERNAL_STORAGE
install permissions:
android.permission.INTERNET: granted=true
android.permission.ACCESS_NETWORK_STATE: granted=true
android.permission.ACCESS_WIFI_STATE: granted=true
User 0: ceDataInode=1155675 installed=true hidden=false suspended=false stopped=true notLaunched=false enabled=0
gids=[3003]
runtime permissions:
android.permission.READ_EXTERNAL_STORAGE: granted=true
android.permission.READ_PHONE_STATE: granted=true
android.permission.WRITE_EXTERNAL_STORAGE: granted=true
User 999: ceDataInode=0 installed=false hidden=false suspended=false stopped=true notLaunched=true enabled=0
gids=[3003]
runtime permissions:
Dexopt state:
[org.mazhuang.guanggoo]
Instruction Set: arm64
path: /data/app/org.mazhuang.guanggoo-2/base.apk
status: /data/app/org.mazhuang.guanggoo-2/oat/arm64/base.odex [compilation_filter=speed-profile, status=kOatUpToDa
te]