学而实习之 不亦乐乎

Android：adb shell 命令用法详解（一）

2022-01-07 08:15:28

一、ADB 概述

ADB，即 Android Debug Bridge 是一种允许模拟器或已连接的 Android 设备进行通信的命令行工具，它可为各种设备操作提供便利，如安装和调试应用，并提供对 Unix shell（可用来在模拟器或连接的设备上运行各种命令）的访问。可以在Android SDK/platform-tools中找到 adb 工具或下载 ADB Kits 。
注： 有部分命令的支持情况可能与 Android 系统版本及定制 ROM 的实现有关。

ADB 是 Android SDK 里的一个工具, 用这个工具可以直接操作管理Android模拟器或者真实的Android设备。它的主要功能有:

  1. 在设备上运行Shell命令；
  2. 将本地APK软件安装至模拟器或Android设备；
  3. 管理设备或手机模拟器上的预定端口；
  4. 在设备或手机模拟器上复制或粘贴文件

ADB 是一个客户端-服务器程序程序，包括三个组件：

  1. 客户端：该组件发送命令。客户端在开发计算机上运行。您可以通过发出 adb 命令从命令行终端调用客户端。
  2. 后台程序：该组件在设备上运行命令。后台程序在每个模拟器或设备实例上作为后台进程运行。
  3. 服务器：该组件管理客户端和后台程序之间的通信。服务器在开发计算机上作为后台进程运行。

二、ADB命令语法

adb 命令的基本语法如下：

adb [-d|-e|-s <serial-number>] <command>

1.单一设备/模拟器连接
如果只有一个设备/模拟器连接时，可以省略掉 [-d|-e|-s <serial-number>] 这一部分，直接使用 adb <command>。

2.多个设备/模拟器连接
如果有多个设备/模拟器连接，则需要为命令指定目标设备，下表是指定目标设备的命令选项：

-d：指定当前唯一通过 USB 连接的 Android 设备为命令目标

-e：指定当前唯一运行的模拟器为命令目标

-s <serial-number>：指定相应设备序列号的设备/模拟器为命令目标

在多个设备/模拟器连接的情况下较常用的是 -s <serial-number> 参数，serial-number是指设备的设备序列号，可以通过 adb devices 命令获取。

三、实例

1.基本使用

查看adb的版本信息
adb version

启动adb，一般无需手动执行此命令，在运行 adb 命令时若发现 adb server 没有启动会自动调起。
adb start-server

停止adb
adb kill-server

以 root 权限运行 adbd
adb root

指定 adb server 的网络端口，ADB的默认端口为 5037。
adb -P <port> start-server

查询已连接的设备/模拟器列表
adb devices

2.设备连接管理

2.1 USB 连接
通过 USB 连接来正常使用 adb 需要以下步骤：

  1. 确认硬件状态正常(包括 Android 设备处于正常开机状态，USB 连接线和各种接口完好)。
  2. Android 设备的开发者选项和 USB 调试模式已开启(可以在「设置」-「开发者选项」-「USB调试」打开USB调试)。
  3. 确认设备驱动状态正常(安装ADB驱动程序)。
  4. 通过 USB 线连接好电脑和设备后确认状态。
  5. 通过 adb devices 命令查看设备连接情况。

2.2 WLAN 连接（需要 USB 线）
借助 USB 通过 WiFi 连接来正常使用 adb 需要以下步骤：

  1. 将 Android 设备与要运行 adb 的电脑连接到同一个 WiFi。
  2. 将设备与电脑通过 USB 线连接(可通过 adb devices 命令查看设备连接情况)。
  3. 通过 adb tcpip 5555 命令让设备在 5555 端口监听 TCP/IP 连接。
  4. 断开 USB 连接。
  5. 找到设备的 IP 地址(可以在「设置」-「关于手机」-「状态信息」-「IP地址」查看 IP 地址)。
  6. 通过 adb connect <device-ip-address> 命令使用 IP 地址将 Android 设备与电脑连接。
  7. 通过 adb devices 命令查看设备连接情况。
  8. 使用完毕后可通过 adb disconnect <device-ip-address> 命令断开无线连接。

2.3 WLAN 连接（无需借助 USB 线）
注：需要 root 权限。
不借助 USB 通过 WiFi 连接来正常使用 adb 需要以下步骤：

1.在 Android 设备上安装一个终端模拟器(可通过Terminal Emulator for Android Downloads下载)。
2.将 Android 设备与要运行 adb 的电脑连接到同一个 WiFi。
3.打开 Android 设备上的终端模拟器，在里面依次运行命令：
    su
    setprop service.adb.tcp.port 5555

4.找到设备的 IP 地址(可以在「设置」-「关于手机」-「状态信息」-「IP地址」查看 IP 地址)。
5.通过 adb connect <device-ip-address> 命令使用 IP 地址将 Android 设备与电脑连接。
6.通过 adb devices 命令查看设备连接情况。

2.4 WiFi 连接转为 USB 连接

通过adb usb命令以USB模式重新启动ADB：adb usb

3.应用管理

3.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：只显示 disabled 的应用
-e：只显示 enabled 的应用
-s：只显示系统应用
-3：只显示第三方应用
-i：显示应用的 installer
-u：包含已卸载应用
<filter>：包名包含 <filter> 字符串

3.2 安装应用

安装应用的基本命令格式是：
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：授予所有运行时权限

adb install 实际是分三步完成：

  1. push apk 文件到 /data/local/tmp。
  2. 调用 pm install 安装。
  3. 删除 /data/local/tmp 下的对应 apk 文件。

运行命令后可以看到输出内容，包含安装进度和状态，安装状态如下：

  • Success：代表安装成功。
  • Failure：代表安装失败。

APK 安装失败的情况有很多，Failure状态之后有安装失败输出代码。常见安装失败输出代码、含义及可能的解决办法如下：

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 签名一致，被当作内置应用。
2. 确认 sdcard 可用，或者安装到内置存储;2. 打包时不与 ROM 使用相同签名。
INSTALL_FAILED_INVALID_INSTALL_LOCATION：
1. 不能安装到指定位置;2. 应用签名与 ROM 签名一致，被当作内置应用。
2. 切换安装位置，添加或删除 -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：用户被限制安装应用
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!：已安装该应用且签名不一致。先卸载设备上的该应用，再安装

3.3 卸载应用

卸载应用的基本命令格式是：
adb uninstall [-k] <package-name>

<package-name> 表示应用的包名，-k 参数可选，表示卸载应用但保留数据和缓存目录。

3.4 清除应用数据与缓存

adb shell pm clear <package-name>

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

3.5 查看前台 Activity

adb shell dumpsys activity activities | grep mFocusedActivity

3.6 查看正在运行的 Services
adb shell dumpsys activity services [<package-name>]
<package-name> 参数不是必须的，指定 <package-name> 表示查看与某个包名相关的 Services，不指定表示查看所有 Services。<package-name> 不一定要给出完整的包名，可以只给一部分，那么所给包名相关的 Services 都会列出来。

3.7 查看应用详细信息
adb shell dumpsys package <package-name>
<package-name> 表示应用包名。运行次命令的输出中包含很多信息，包括 Activity Resolver Table、Registered ContentProviders、包名、userId、安装后的文件资源代码等路径、版本信息、权限信息和授予状态、签名版本信息等。

3.8 查看应用安装路径
adb shell pm path <package-name>