在您的设备上启用 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 连接到设备的详细信息,请参阅在硬件设备上运行应用。
通过 WLAN 连接到设备
一般情况下,通过 USB 使用 adb。不过,也可以按照下面的说明通过 WLAN 使用它。
将 Android 设备和 adb 主计算机连接到这两者都可以访问的常用 WLAN 网络。请注意,并非所有访问点均适用;您可能需要使用已正确配置防火墙的访问点以支持 adb 的访问点。
注:如果您尝试连接到 Android Wear 设备,则通过关闭与其连接的手机的蓝牙强制将它连接到 WLAN。
- 使用 USB 电缆将设备连接到主计算机。
- 设置目标设备以侦听端口 5555 上的 TCP/IP 连接。
$ adb tcpip 5555
- 从目标设备断开 USB 电缆连接。
- 查找 Android 设备的 IP 地址。例如,在 Nexus 设备上,您可以通过访问 Settings > About tablet(或 About phone) > Status > IP address 查找 IP 地址。或者,在 Android Wear 设备上,您可以通过访问 Settings > Wi-Fi Settings > Advanced > IP address 查找 IP 地址。
- 连接至设备,通过 IP 地址识别此设备。
$ adb connect device_ip_address
- 请确认您的主计算机已连接至目标设备:
$ adb devices List of devices attached device_ip_address:5555 device
现在,您可以开始操作了!
如果 adb 连接丢失:
- 请确保您的主机仍与您的 Android 设备连接到同一个 WLAN 网络。
- 通过再次执行
adb connect
步骤重新连接。 - 如果无法连接,则重置 adb 主机:
adb kill-server
然后,从头开始操作。
查询设备
在发出 adb 命令之前,知道哪些模拟器/设备实例已连接到 adb 服务器会很有帮助。您可以使用 devices
命令生成已连接的模拟器/设备的列表:
adb devices
在响应时,adb 针对每个实例输出此状态信息:
- 序列号 — 一个由 adb 创建的字符串,用于通过其控制台端口号唯一标识模拟器/设备实例。序列号的格式为
type-console-port
。下面是一个序列号示例:emulator-5554
- 状态 — 实例的连接状态可为下列状态之一:
offline
— 实例未连接到 adb 或不响应。device
— 实例现在已连接到 adb 服务器。请注意,此状态并不表示 Android 系统已完全启动且可以运行,因为在此实例连接到 adb 时系统仍在启动。不过,在启动后,这将是模拟器/设备实例的正常运行状态。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
命令。使用此命令,您必须指定您要安装的 APK 文件的路径:
adb install path_to_apk
如需有关如何创建可在模拟器/设备实例上安装的 APK 文件的详细信息,请参阅构建和运行您的应用。
请注意,如果使用 Android Studio,则无需直接使用 adb(或 aapt)在模拟器/设备上安装您的应用。而是由 Android Studio 为您处理应用的打包和安装。
设置端口转发
您可以使用 forward
命令设置任意端口转发 — 将对特定主机端口的请求转发到模拟器/设备实例上的其他端口。下面向您介绍如何设置主机端口 6100 到模拟器/设备端口 7100 的转发:
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 服务器,请使用 adb kill-server
命令。然后,您可以通过发出任意其他 adb 命令重启服务器。
进行屏幕截图
screencap
命令是一个用于对设备显示屏进行屏幕截图的 shell 实用程序。在 shell 中,此语法为:
screencap filename
要从命令行使用 screencap
,请输入以下命令:
$ adb shell screencap /sdcard/screen.png
以下屏幕截图会话示例向您展示使用 adb shell 捕获屏幕截图,并使用 pull
命令从设备下载此文件:
$ adb shell shell@ $ screencap /sdcard/screen.png shell@ $ exit $ adb pull /sdcard/screen.png