参考链接：https://developer.android.com/studio/command-line/adb.html

Android 调试桥 (adb) 是一个通用命令行工具，其允许您与模拟器实例或连接的 Android 设备进行通信。它可为各种设备操作提供便利，如安装和调试应用，并提供对 Unix shell（可用来在模拟器或连接的设备上运行各种命令）的访问。该工具作为一个客户端-服务器程序，包括三个组件：

您可以在 ​​android_sdk/platform-tools/​​ 中找到 ​​adb​​

启动一个 adb 客户端时，此客户端首先检查是否有已运行的 adb 服务器进程。如果没有，它将启动服务器进程。当服务器启动时，它与本地 TCP 端口 5037 绑定，并侦听从 adb 客户端发送的命令—所有 adb 客户端均使用端口 5037 与 adb 服务器通信。

然后，服务器设置与所有运行的模拟器/设备实例的连接。它通过扫描 5555 到 5585 之间（模拟器/设备使用的范围）的奇数号端口查找模拟器/设备实例。服务器一旦发现 adb 后台程序，它将设置与该端口的连接。请注意，每个模拟器/设备实例将获取一对按顺序排列的端口 — 用于控制台连接的偶数号端口和用于 adb 连接的奇数号端口。例如：

模拟器 1，控制台：5554 模拟器 1，adb：5555 模拟器 2，控制台：5556 模拟器 2，adb：5557 以此类推...

如上所示，在端口 5555 与 adb 连接的模拟器实例与侦听端口 5554 的控制台的实例相同。

当服务器已设置与所有模拟器实例的连接后，您可以使用 adb 命令访问这些实例。由于服务器管理与模拟器/设备实例的连接，并处理来自多个 adb 客户端的命令，因此，您可以从任意客户端（或从某个脚本）控制任意模拟器/设备实例。

要在通过 USB 连接的设备上使用 adb，您必须在设备系统设置中启用 USB debugging（位于 Developer options 下）。

在运行 Android 4.2 及更高版本的设备上，Developer options 屏幕默认情况下处于隐藏状态。如需将其显示出来，请转到 Settings > About phone 并点按 Build number 七次。返回上一屏幕，在底部可以找到 Developer options。

在某些设备上，Developer options 屏幕所在的位置或命名方式可能有所不同。

现在，您可以将设备与 USB 连接。可以从 ​​android_sdk/platform-tools/​​ 目录执行 ​​adb devices​​

注：当您连接运行 Android 4.2.2 或更高版本的设备时，系统将显示一个对话框，询问您是否接受允许在这台计算机上调试的 RSA 密钥。这种安全机制可以保护用户设备，因为它可以确保只有在您能够解锁设备并确认对话框的情况下才能执行 USB 调试和其他 ADB 命令。

如需了解有关通过 USB 连接到设备的详细信息，请参阅​​在硬件设备上运行应用​​。

一般情况下，通过 USB 使用 adb。不过，也可以按照下面的说明通过 WLAN 使用它。

现在，您可以开始操作了！

如果 adb 连接丢失：

​​adb connect​​

在发出 adb 命令之前，知道哪些模拟器/设备实例已连接到 adb 服务器会很有帮助。您可以使用 ​​devices​​

adb devices

在响应时，adb 针对每个实例输出此状态信息：

​​type-console-port​​

​​emulator-5554​​

​​offline​​​​device​​​​no device​​

输出的格式类似如下：

List of devices attached serial_number state

以下示例向您展示了 ​​devices​​

adb devices List of devices attached emulator-5554  device emulator-5556  device emulator-5558  device

如果多个模拟器/设备实例正在运行，在发出 adb 命令时您必须指定一个目标实例。为此，请在命令中使用 ​​-s​​ 选项。以下是 ​​-s​​

adb -s serial_number command

如上所示，您使用由 adb 分配的序列号为命令指定目标实例。您可使用 ​​devices​​

adb -s emulator-5556 install helloWorld.apk

注意，如果在多个设备可用时您未指定目标模拟器/设备实例就发出命令，那么 adb 将生成一个错误。

如果您有多个设备可用（硬件或模拟设备），但只有一个设备是模拟器，则使用 ​​-e​​ 选项将命令发送至该模拟器。同样，如果有多个设备，但只连接了一个硬件设备，则使用 ​​-d​​

您可以使用 adb 从开发计算机复制应用，并将其安装到模拟器/设备实例上。为此，请使用 ​​install​​

adb install path_to_apk

如需有关如何创建可在模拟器/设备实例上安装的 APK 文件的详细信息，请参阅​​构建和运行您的应用​​。

请注意，如果使用 Android Studio，则无需直接使用 adb（或 aapt）在模拟器/设备上安装您的应用。而是由 Android Studio 为您处理应用的打包和安装。

您可以使用 ​​forward​​

adb forward tcp:6100 tcp:7100

您也可以使用 adb 设置传输到指定的抽象 UNIX 网域套接字的转发，如下所示：

adb forward tcp:6100 local:logd

您可以使用 adb 命令 ​​pull​​ 和 ​​push​​ 将文件复制到模拟器/设备实例或从其中复制文件。与 ​​install​​ 命令不同（其仅将 APK 文件复制到特定位置），​​pull​​和 ​​push​​

要从模拟器或设备复制文件或目录（及其子目录），请使用

adb pull remote local

要将文件文件或目录（及其子目录）复制到模拟器或设备，请使用

adb push local remote

在上述命令中，​​local​​ 和 ​​remote​​

adb push foo.txt /sdcard/foo.txt

在某些情况下，您可能需要终止 adb 服务器进程，然后重启它以解决问题（例如，如果 adb 不响应命令）。

要停止 adb 服务器，请使用 ​​adb kill-server​​

您可以在开发计算机上从命令行发出 adb 命令，或通过脚本发出。用法如下：

adb [-d|-e|-s serial_number] command

如果只有一个模拟器在运行或只连接了一个设备，则默认情况下将 adb 命令发送至该设备。如果有多个模拟器在运行和/或连接了多个设备，您需要使用 ​​-d​​、​​-e​​ 或 ​​-s​​

下表列出了所有支持的 adb 命令并解释其含义和用法。

表 1. 可用的 adb 命令

类别

命令

说明

注释

目标设备

​​-d​​

将 adb 命令发送至唯一连接的 USB 设备。

如果连接了多个 USB 设备，将返回错误。

​​-e​​

将 adb 命令发送至唯一运行的模拟器实例。

如果有多个模拟器实例在运行，将返回错误。

​​-s serial_number​​

将 adb 命令发送至以其 adb 分配的序列号命名的特定模拟器/设备实例（如“emulator-5556”）。

请参阅​​将命令发送至特定模拟器/设备实例​​。

常规

​​devices​​

输出所有连接的模拟器/设备实例的列表。

如需了解详细信息，请参阅​​查询模拟器/设备实例​​。

​​help​​

输出支持的 adb 命令的列表。

​​version​​

输出 adb 版本号。

调试

​​logcat [option] [filter-specs]​​

将日志数据输出到屏幕。

​​bugreport​​

​​dumpsys​​、​​dumpstate​​ 和 ​​logcat​​数据输出到屏幕，以用于报告错误。

​​jdwp​​

输出给定设备上可用的 JDWP 进程的列表。

​​forward jdwp:pid​​ 端口转发规范以连接到特定的 JDWP 进程。例如：

​​adb forward tcp:8000 jdwp:472​​

​​jdb -attach localhost:8000​​

数据

​​install path_to_apk​​

将 Android 应用（使用 APK 文件的完整路径表示）推送到模拟器/设备。

​​pull remote local​​

从模拟器/设备实例将指定文件复制到开发计算机。

​​push local remote​​

从开发计算机将指定文件复制到模拟器/设备实例。

端口和网络连接

​​forward local remote​​

将来自指定本地端口的套接字连接转发到模拟器/设备实例上的指定远程端口。

​​tcp:port_number​​​​local:unix_domain_socket_name​​​​dev:character_device_name​​​​jdwp:pid​​

​​ppp tty​​

​​tty​​

​​dev:/dev/omap_csmi_ttyl​​

​​[parm]... ​​

​​defaultroute​​

​​local​​

​​notty​​

请注意，不得自动启动 PPP 连接。

脚本

​​get-serialno​​

输出 adb 实例序列号字符串。

如需了解详细信息，请参阅​​查询模拟器/设备实例​​。

​​get-state​​

输出模拟器/设备实例的 adb 状态。

​​wait-for-device​​

​​device​​。

adb wait-for-device shell getprop

请注意，此命令不会使 adb 等待整个系统已完全启动。因此，您不应将其追加到需要系统完全启动的其他命令。例如，​​install​​ 需要使用 Android 软件包管理器，其仅在系统完全启动后才可用。如下命令

adb wait-for-device install app.apk

在模拟器或设备实例连接到 adb 服务器时立即发出 ​​install​​

服务器

​​start-server​​

检查 adb 服务器进程是否在运行，如果未运行则启动它。

​​kill-server​​

终止 adb 服务器进程。

Shell

​​shell​​

在目标模拟器/设备实例中启动远程 shell。

如需了解详细信息，请参阅​​发出 shell 命令​​。

​​shell shell_command​​

在目标模拟器/设备实例中发出 shell 命令，然后退出远程 shell。

您可以使用 ​​shell​​ 命令通过 adb 发出设备命令，可以进入或不进入模拟器/设备实例上的 adb 远程 shell。要在不进入远程 shell 的情况下发出一个命令，请使用如下 ​​shell​​

adb [-d|-e|-s serial_number] shell shell_command

或者，使用如下命令进入模拟器/设备实例上的远程 shell：

adb [-d|-e|-s serial_number] shell

当您准备退出远程 shell 时，按 Control + D 或输入 ​​exit​​。shell 命令二进制文件存储在模拟器或设备的文件系统中，其路径为 ​​/system/bin/​​。

在 adb shell 中，您可以使用 Activity Manager (​​am​​) 工具发出命令以执行各种系统操作，如启动 Activity、强行停止进程、广播 intent、修改设备屏幕属性及其他操作。在 shell 中，此语法为：

am command

您也可以直接从 adb 发出 Activity Manager 命令，无需进入远程 shell。例如：

adb shell am start -a android.intent.action.VIEW

表 2. 可用的 Activity Manager 命令

命令

说明

​​start [options] intent​​

​​intent​​ 指定的 ​​​Activity​​​。

请参阅 ​​intent 参数的规范​​。

选项包括：

​​-D​​

​​-W​​

​​--start-profiler file​​

​​file​​

​​-P file​​

​​--start-profiler​​

​​-R count​​

​​count​​​​-S​​

​​--opengl-trace​​

​​--user user_id​​

​​startservice [options] intent​​

​​intent​​ 指定的 ​​​Service​​​。

请参阅 ​​intent 参数的规范​​。

选项包括：

​​--user user_id​​

​​force-stop package​​

​​package​​（应用的包名称）关联的所有应用。

​​kill [options] package​​

​​package​​（应用的包名称）关联的所有进程。此命令仅终止可安全终止且不会影响用户体验的进程。

选项包括：

​​--user user_id​​

​​kill-all​​

终止所有后台进程。

​​broadcast [options] intent​​

请参阅 ​​intent 参数的规范​​。

选项包括：

​​[--user user_id​​

​​instrument [options] component​​

​​​Instrumentation​​​ 实例启动监控。通常，目标 ​​component​​ 是表单 ​​test_package/runner_class​​。

选项包括：

​​-r​​

​​report_key_streamresult​​

​​[-e perf true]​​​​-e name value​​

​​name​​

​​value​​

​​-e testrunner_flagvalue[,value...]​​

​​-p file​​

​​file​​

​​-w​​

​​--no-window-animation​​

​​--user user_id​​

​​profile start process file​​

​​process​​ 的分析器，将结果写入 ​​file​​。

​​profile stop process​​

​​process​​

​​dumpheap [options] process file​​

​​process​​ 的堆，写入 ​​file​​。

选项包括：

​​--user [user_id|current]​​

​​-n​​

​​set-debug-app [options] package​​

​​package​​ 设为调试。

选项包括：

​​-w​​

​​--persistent​​

​​clear-debug-app​​

​​set-debug-app​​

​​monitor [options]​​

选项包括：

​​--gdb​​

​​screen-compat {on|off} package​​

​​package​​ 的​​​屏幕兼容性​​模式。

​​display-size [reset|widthxheight]​​

示例：

​​am display-size 1280x800​​

​​display-density dpi​​

示例：

​​am display-density 480​​

​​to-uri intent​​

请参阅 ​​intent 参数的规范​​。

​​to-intent-uri intent​​

​​intent:​​URI 的形式输出。

请参阅 ​​intent 参数的规范​​。

在 adb shell 中，您可以使用软件包管理器 (​​pm​​) 工具发出命令，以对设备上安装的应用软件包进行操作和查询。在 shell 中，此语法为：

pm command

您也可以直接从 adb 发出软件包管理器命令，无需进入远程 shell。例如：

adb shell pm uninstall com.example.MyApp

表 3. 可用的软件包管理器命令。

命令

说明

​​list packages [options] filter​​

​​filter​​ 中的文本的软件包。

选项：

​​-f​​

​​-d​​

​​-e​​

​​-s​​

​​-3​​

​​-i​​

​​-u​​

​​--user user_id​​

​​list permission-groups​​

输出所有已知的权限组。

​​list permissions [options] group​​

​​group​​ 中的权限。

选项：

​​-g​​

​​-f​​

​​-s​​

​​-d​​

​​-u​​

​​list instrumentation [options]​​

选项：

​​-f​​

​​target_package​​

​​list features​​

输出系统的所有功能。

​​list libraries​​

输出当前设备支持的所有库。

​​list users​​

输出系统上的所有用户。

​​path package​​

​​package​​

​​install [options] path​​

​​path​​ 指定）安装到系统。

选项：

​​-l​​

​​-r​​

​​-t​​

​​-i installer_package_name​​

​​-s​​

​​-f​​

​​-d​​

​​-g​​

​​uninstall [options] package​​

选项：

​​-k​​

​​clear package​​

删除与软件包关联的所有数据。

​​enable package_or_component​​

启用给定软件包或组件（作为“package/class”写入）。

​​disable package_or_component​​

停用给定软件包或组件（作为“package/class”写入）。

​​disable-user [options] package_or_component​​

选项：

​​--user user_id​​

​​grant package_name permission​​

向应用授予权限。在运行 Android 6.0（API 级别 23）及更高版本的设备上，可以是应用清单中声明的任何权限。在运行 Android 5.1（API 级别 22）和更低版本的设备上，必须是应用定义的可选权限。

​​revoke package_name permission​​

从应用中撤销权限。在运行 Android 6.0（API 级别 23）及更高版本的设备上，可以是应用清单中声明的任何权限。在运行 Android 5.1（API 级别 22）和更低版本的设备上，必须是应用定义的可选权限。

​​set-install-location location​​

​​0​​

​​1​​

​​2​​

注：此命令仅用于调试目的；使用此命令会导致应用中断和其他意外行为。

​​get-install-location​​

​​0 [auto]​​

​​1 [internal]​​

​​2 [external]​​

​​set-permission-enforced permission[true|false]​​

指定是否应强制执行给定的权限。

​​trim-caches desired_free_space​​

减少缓存文件以达到给定的可用空间。

​​create-user user_name​​

​​user_name​​

​​remove-user user_id​​

​​user_id​​

​​get-max-users​​

输出设备支持的最大用户数。

​​screencap​​

screencap filename

要从命令行使用 ​​screencap​​，请输入以下命令：

以下屏幕截图会话示例向您展示使用 adb shell 捕获屏幕截图，并使用 ​​pull​​

​​screenrecord​​

注：音频不与视频文件一起录制。

开发者可以使用此文件创建宣传视频或培训视频。在 shell 中，此语法为：

screenrecord [options] filename

要从命令行使用 ​​screenrecord​​，请输入以下命令：

按 Control + C 停止屏幕录制，否则，到三分钟或 ​​--time-limit​​要开始录制设备屏幕，请运行 ​​screenrecord​​ 命令以录制视频。然后，运行 ​​pull​​

​​screenrecord​​下面是 ​​screenrecord​​

表 4. ​​screenrecord​​

选项

说明

​​--help​​

显示命令语法和选项

​​--size widthxheight​​

​​1280x720​​。默认值是设备的原生显示分辨率（如果支持），如果不支持，则使用 1280x720。为实现最佳结果，请使用设备的 Advanced Video Coding (AVC) 编码器支持的大小。

​​--bit-rate rate​​

​​--time-limit time​​

设置最大录制时长（以秒为单位）。默认值和最大值均为 180（3 分钟）。

​​--rotate​​

将输出旋转 90 度。此功能是实验性的。

​​--verbose​​

显示命令行屏幕上的日志信息。如果您不设置此选项，则运行时此实用程序不会显示任何信息。

从 Android 7.0（API 级别 24）开始，Android Runtime (ART) 会收集已安装应用的执行配置文件，其可用于优化应用性能。您可能想要检查收集的配置文件，以了解在应用启动期间，系统决定频繁执行哪些方法和使用哪些类。

要生成配置文件信息的文本表单，请使用以下命令：

$ adb shell cmd package dump-profiles package

要检索生成的文件，请使用：

$ adb pull /data/misc/profman/package.txt

如需所有可用 shell 程序的列表，请使用以下命令：

adb shell ls /system/bin

大多数命令都提供帮助说明。

表 5 列出了一些比较常用的 adb shell 命令。

表 5. 其他一些 adb shell 命令

Shell 命令

说明

注释

​​dumpsys​​

将系统数据转储到屏幕。

​​Dalvik Debug Monitor Server​​ (DDMS) 工具提供了一个集成调试环境，让您用起来更方便。

​​dumpstate​​

将状态转储到文件。

​​logcat [option]... [filter-spec]...​​

启用系统和应用日志记录，并将输出传输到屏幕。

​​dmesg​​

将内核调试消息输出到屏幕。

​​start​​

启动（重启）模拟器/设备实例。

​​stop​​

停止执行模拟器/设备实例。