ADB 操作命令详解及用法大全

一、ADB是什么？

ADB，即 Android Debug Bridge 是一种允许模拟器或已连接的 Android 设备进行通信的命令行工具，它可为各种设备操作提供便利，如安装和调试应用，并提供对 Unix shell（可用来在模拟器或连接的设备上运行各种命令）的访问。可以在Android SDK/platform-tools中找到 adb 工具或下载 ADB Kits 。

注： 有部分命令的支持情况可能与 Android 系统版本及定制 ROM 的实现有关。

二、ADB有什么作用？

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

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

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

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

三、ADB命令语法

adb 命令的基本语法如下：

adb [-d|-e|-s <serial-number>] <command>
复制代码

单一设备/模拟器连接

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

多个设备/模拟器连接

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

参数	含义
-d	指定当前唯一通过 USB 连接的 Android 设备为命令目标
-e	指定当前唯一运行的模拟器为命令目标
-s <serial-number>	指定相应设备序列号的设备/模拟器为命令目标

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

四、ADB常用命令

4.1 基本命令

4.1.1 查看adb的版本信息

adb version
复制代码

4.1.2 启动adb

adb start-server
复制代码

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

4.1.3 停止adb

adb kill-server
复制代码

4.1.4 以 root 权限运行 adbd

adb root
复制代码

4.1.5 指定 adb server 的网络端口

adb -P <port> start-server
复制代码

ADB的默认端口为 5037。

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

adb devices
复制代码

4.2 设备连接管理

4.2.1 USB 连接

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

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

4.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> 命令断开无线连接。

4.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 命令查看设备连接情况。

4.2.4 WiFi 连接转为 USB 连接

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

adb usb
复制代码

4.3 应用管理

4.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> 字符串

4.3.1.1 查看所有应用

adb shell pm list packages
复制代码

4.3.1.2 查看系统应用

adb shell pm list packages -s
复制代码

4.3.1.3 查看第三方应用

adb shell pm list packages -3
复制代码

4.3.1.4 包名包含某字符串的应用

比如要查看包名包含字符串 huawei 的应用列表，命令：

adb shell pm list packages huawei
复制代码

4.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	授予所有运行时权限

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

• 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 签名一致，被当作内置应用。	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	用户被限制安装应用
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!	已安装该应用且签名不一致	先卸载设备上的该应用，再安装

参考：