ADB——管理应用

ADB应用管理

　　主要操作有查看应用列表、安装应用、卸载应用、清楚应用数据与缓存、查看前台Activity、查看应用信息及安装路径等等

查看应用列表

　　查看应用列表的基本命令格式是

adb shell pm list packages [-f] [-d] [-e] [-s] [-3] [-i] [-u] [--user USER_ID] [FILTER]

　　即在adb shell pm list packages的基础上可以加一些参数进行过滤查看不同的列表，支持的过滤参数如下：

参数	显示列表
无	所有应用
-f	显示应用关联的 apk 文件
-d	只显示 disabled 的应用
-e	只显示 enabled 的应用
-s	只显示系统应用
-3	只显示第三方应用
-i	显示应用的 installer
-u	包含已卸载应用
<FILTER>	包名包含<FILTER>的字符串

• 查看所有应用

  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
  ...
  '''

• 查看系统应用

  adb shell pm list packages -s

• 查看第三方应用

  adb shell pm list packages -3

• 查看某个包名中包含指定字符的应用

  # 比如要查看包名包含字符串 python 的应用列表
  adb shell pm list packages python
  
  # 也可以使用 grep 来过滤：
  adb shell pm list packages | grep python

安装应用

adb install [-lrtsdg] <path_to_apk>

　　

实际上 adb install 是分三步完成：

1. push apk 文件到 /data/local/tmp。

2. 调用 pm install 安装。

3. 删除 /data/local/tmp 下的对应 apk 文件。

　　所以，必要的时候也可以根据这个步骤，手动分步执行安装过程。

　　adb install后面可以跟一些可选参数来控制安装 APK 的行为，可用参数及含义如下：

参数	含义
-l	将应用安装到保护目录 /mnt/asec
-r	允许覆盖安装
-t	允许安装 AndroidManifest.xml 里 application 指定android:testOnly="true"的应用
-s	将应用安装到 sdcard
-d	允许降级覆盖安装
-g	授予所有运行时权限

　　运行命令后如果见到类似如下输出（状态为Success）代表安装成功：

# 当前最新版 v1.0.36 的 adb 的输出，会显示 push apk 文件到手机的进度百分比。
[100%] /data/local/tmp/1.apk
    pkg: /data/local/tmp/1.apk
Success

# 使用旧版本 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]

　　常见安装失败输出代码、含义及可能的解决办法如下：

输出	含义	解决办法
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	设备里已经存在与应用里同名的content provider
INSTALL_FAILED_NEWER_SDK	设备系统版本高于应用要求
INSTALL_FAILED_TEST_ONLY	应用是 test-only 的，但安装时没有指定 -t 参数
INSTALL_FAILED_CPU_ABI_INCOMPATIBLE	包含不兼容设备 CPU 应用程序二进制接口的 native code
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	已安装 target SDK 支持运行时权限的同名应用，要安装的版本不支持运行时权限
INSTALL_PARSE_FAILED_NOT_APK	指定路径不是文件，或不是以 .apk 结尾
INSTALL_PARSE_FAILED_BAD_MANIFEST	无法解析的 AndroidManifest.xml 文件
INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION	解析器遇到异常
INSTALL_PARSE_FAILED_NO_CERTIFICATES	安装包没有签名
INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES	已安装该应用，且签名与 APK 文件不一致	先卸载设备上的该应用，再安装
INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING	解析 APK 文件时遇到CertificateEncodingException
INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME	manifest 文件里没有或者使用了无效的包名
INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID	manifest 文件里指定了无效的共享用户 ID
INSTALL_PARSE_FAILED_MANIFEST_MALFORMED	解析 manifest 文件时遇到结构性错误
INSTALL_PARSE_FAILED_MANIFEST_EMPTY	在 manifest 文件里找不到找可操作标签（instrumentation 或 application）
INSTALL_FAILED_INTERNAL_ERROR	因系统问题安装失败
INSTALL_FAILED_USER_RESTRICTED	用户被限制安装应用	在开发者选项里将「USB安装」打开，如果已经打开了，那先关闭再打开。
INSTALL_FAILED_DUPLICATE_PERMISSION	应用尝试定义一个已经存在的权限名称
INSTALL_FAILED_NO_MATCHING_ABIS	应用包含设备的应用程序二进制接口不支持的 native code
INSTALL_CANCELED_BY_USER	应用安装需要在设备上确认，但未操作设备或点了取消	在设备上同意安装
INSTALL_FAILED_ACWF_INCOMPATIBLE	应用程序与设备不兼容
INSTALL_FAILED_TEST_ONLY	APK 文件是使用 Android Studio 直接 RUN 编译出来的文件	通过 Gradle 的 assembleDebug 或 assembleRelease 重新编译，或者 Generate Signed APK
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 以下不支持安装到 sdcard	不使用 -s 参数
No space left on device	空间不足	清理空间
Permission denied ... sdcard ...	sdcard 不可用
signatures do not match the previously installed version; ignoring!	已安装该应用且签名不一致	先卸载设备上的该应用，再安装

参考：PackageManager.java

卸载应用

adb uninstall [-k] <packagename>
# <packagename> 表示应用的包名，-k 参数可选，表示卸载应用但保留数据和缓存目录。

adb uninstall com.qihoo360.mobilesafe # 卸载 360 手机卫士。

清楚应用数据与缓存

adb shell pm clear <packagename>
# <packagename> 表示应用名包，这条命令的效果相当于在设置里的应用信息界面点击了「清除缓存」和「清除数据」。

adb shell pm clear com.qihoo360.mobilesafe # 表示清除 360 手机卫士的数据和缓存。

查看前台Activity

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。

查看运行的services

adb shell dumpsys activity services [<packagename>]
# <packagename> 参数不是必须的，指定 <packagename> 表示查看与某个包名相关的 Services，不指定表示查看所有 Services。
# <packagename> 不一定要给出完整的包名，比如运行adb shell dumpsys activity services org.xxx，那么包名org.xxx.demo1、org.xxx.demo2 和 org.xxx123 等相关的Services都会列出来。

查看应用信息

adb shell dumpsys package <packagename> # <packagename> 表示应用包名。
# 输出中包含很多信息，包括 Activity Resolver Table、Registered ContentProviders、包名、userId、安装后的文件资源代码等路径、版本信息、权限信息和授予状态、签名版本信息等。

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]

输出示例

查看应用安装路径

adb shell pm path <PACKAGE>
# 如
adb shell pm path ecarx.weather # package:/data/app/ecarx.weather-1.apk