Android调试桥(adb)是一个让你和模拟器或真机通讯的通用命令行工具。它是CS程序,包含以下3个组件:
1. 客户端,运行在你的开发机上。你可以从shell发出一个adb命令调出客户端。或者使用Android工具,例如:ADT插件和DDMS可以调出adb客户端。
2. 服务端,运行在开发机的后台进程。服务管理客户端和模拟器或者真机上运行的adb守护进程之间的沟通。
3. 守护进程,运行在模拟器或者真机的后台进程。
你可以在<sdk>/platform-tools/
找到adb工具
当你启动一个adb客户端,客户端首先会检查是否有服务进行再运行。如果没有,它会启动服务进程。当服务进程启动了,它会绑定TCP 5037端口,并监听从客户端发过来的命令,所有的adb客户端使用5037端口和adb服务交互。
服务建立和模拟器或者真机的链接。它通过扫描5555和5585之间的奇数端口,来定位模拟器或者真机,这个端口范围是模拟器或者真机使用的。当服务发现守护进程,它会建立那个端口的链接。注意,每个模拟器或者真机需要一对连续的端口,一个偶数端口控制链接,一个奇数端口是adb链接。例如:
模拟器1,控制端口:5554
模拟器1,adb端口:5555
模拟器2,控制端口:5556
模拟器2,adb端口:5557
如上所示,模拟器在5555端口上连接adb,在5554端口上监听。
一旦服务端对所有的模拟器建立了连接后,你可以使用adb命令访问这些实例。因为服务管理对模拟器或真机的连接,处理从不同adb客户端的请求,你可以从任何客户端(或脚本)控制任何模拟器或真机。
建立adb调试
为了使用adb和设备通过USB连接。你必须启用在设备系统设置中的USB调试,在开发者选项菜单下。
Android4.2
或更高版本,开发者选项默认是隐藏的。进入设置-->关于手机,点击编译版本号7次,可以使它显示。返回上一级菜单,可以在底部寻找到。
在一些设备上,开发者选项可能位置或名字不同。
注意:当你连接Android4.2.2或更高版本的设备到你的电脑上,系统会显示一个对话框,询问是够接受RSK密钥,它可以允许通过你的电脑的调试。这个安全机制保护用户设备,因为它确认USB调试和其他adb命令不能被执行,除非你可以解锁设置,确认这个对话框。这需要adb 1.0.31版本(在
SDK Platform-tools r16.0.1中或更高)以便在Android4.2.2或更高版本中的设备上调试。
语法
你可以在你的开发机上从命令行或脚本发出adb命令。使用方法是:
adb [-d|-e|-s <serialNumber>]<command>
如果只有一个模拟器或真机连接,adb命令默认会发送到那个设备。如果有多个模拟器或真机连接,你需要使用-d, -e, 或 -s选项去指定命令发送的目标设备。
命令
下表显示了所有adb支持的命令,并解释了它们的意思和使用方法。
表1.可用的adb命令
分类 | 命令 | 描述 | 说明 |
目标设备 | "-d" | adb命令直接发送到USB连接的设备 | 如果有1个以上USB连接的设备会返回错误 |
"-e" | adb命令直接发送到模拟器 | 如果有1个以上的模拟器会返回错误 | |
"-s <序列号>" | adb命令直接发送到制定的模拟器或者真机,通过adb制定的序列号(例如:emulator-5556) |
| |
一般 | "devices" | 显示所有连接的模拟器或者真机 |
|
"help" | 显示支持的adb命令 |
| |
"version" | 显示adb版本号 |
| |
调试 | "logcat [选项] [过滤条件]" | 显示日志数据 |
|
"bugreport" | 打印dumpsys,dumpstate和logcat数据到屏幕上,形成故障报告 |
| |
"jdwp" | 显示所有支持jdwp调试的进程pid, | 你可以使用forward jdwp:<pid>, | |
数据 | "install <path-to-apk>" | 向模拟器或真机安装一个Android应用 |
|
"pull <remote> <local>" | 拷贝一个指定的文件从模拟器或真机到 |
| |
"push <local> <remote>" | 拷贝一个指定的文件从开发机到模拟器 |
| |
端口和网络 | "forward <local> <remote>" | 转发一个socket连接,从指定的本地端口到指定的在模拟器或真机的远端端口 | 端口指定可以使用这些格式: |
"ppp <tty> [parm]..." | 通过USB运行PPP: |
| |
脚本 | "get-serialno" | 显示adb连接实例的序列号 |
|
"get-state" | 显示模拟器或真机的adb状态 |
| |
"wait-for-device" | 阻碍执行,直到设备状态是online--当 | 你可以在执行其他adb命令前,执行这个命令,当adb需要等待模拟器或真机连接再发出其他命令时,下面是一个例子: | |
服务 | "start-server" | 检查adb服务进程是否运行,如果没有, |
|
"kill-server" | 结束adb服务进程 |
| |
Shell | "shell" | 启动远端在模拟器或真机的shell |
|
"shell [shellCommand]" | 发出shell命令,在远端模拟器或真机上,然后退出shell |
|
查询模拟器或真机实例
在发出adb命令之前,知道什么模拟器或真机连接到adb服务是有帮助的。你可以生成一个用下面的命令,生成一个模拟器或真机设备的列表:
adb devices
在响应中,adb会显示每个实例的状态信息:
1.
序列号:adb产生的字符串,可以通过控制端口号唯一认定一个模拟器或真机。序列号的格式是:<type>-<consolePort>。这是一个序列号的例子:
emulator-5554
2.
状态:实例的连接状态是下面中的一个:
offline--
实例没有连接到adb服务或没响应
device--
这个实例现在连接到了adb服务。注意这个状态不能指示Android系统是完全启动或者正在启动,当系统启动过程中,实例连接上了adb服务。然而,启动完成后,这是一个模拟器或真机的标准状态。
nodevice--
没有模拟器或真机连接
每个实例的输出格式是这样:
[serialNumber] [state]
这是一个显示设备的命令和输出的例子:
adb devices
List of devices attached
emulator-5554 device
emulator-5556 device
emulator-5558 device
给指定的模拟器或真机发送命令
如果有多个模拟器或真机运行,当发送adb命令时,你必须指定一个目标实例。在命令行中使用-s选项。-s的使用说明如下:
adb -s <serialNumber> <command>
如上所示,你可以指定目标设备,通过命令行中使用adb分配的序列号。你可以使用devices命令去获得运行中的模拟器或真机的序列号。例如:
adb -s emulator-5556 install helloWorld.apk
注意:当有多个设备连接时,如果没有指定目标模拟器或真机就发出命令,adb会产生错误。
如果你有多个设备可用(真机或模拟器),但是只有一个是模拟器简单使用-e选项发送命令给模拟器。同样的,如果有多个设备,但只有一个真机,使用-d选项发送命令给真机。
安装应用
你可以使用adb从开发机拷贝应用,然后安装在模拟器或真机中。使用install命令时,你徐碧指定你想要安装的apk的路径。
adb install <path_to_apk>
注意:如果你使用包含ADT插件的Eclipse IDE,你不需要使用adb(或aapt)在模拟器或真机上安装应用。相反,ADT插件处理打包和安装应用。
端口转发
你可以使用forward命令建立任意端口转发--请求转发模拟器或真机指定的端口到另一个端口。这是建立转发本地6100端口到模拟器或真机7100端口:
adb forward tcp:6100 tcp:7100
你当然可以使用adb建立转发到
abstract UNIX domain sockets,例如:
adb forward tcp:6100 local:logd
向或从模拟器或真机拷贝文件
你可以使用adb命令pull和push从模拟器或真机拷贝文件或向他们拷贝文件。和install命令不同的是,它只是拷贝指定文件到指定位置,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
通常是通过USB使用的。但是,它还可以通过Wifi来使用,就像这里描述的。
1. Android
设备
和adb主机电脑都连接到Wifi。我们发现不是所有的连接点都是合适的,你需要使用防火墙支持adb连接点。
2.
通过USB连接设备到主机上
3.
保证通过USB主机上的adb
服务
是运行的
$ adb usb
restarting in USB mode
4. 通过USB连接设备
$ adb devices
List of devices attached
######## device
5. 在tcpip模式重新启动adb
$ adb tcpip 5555 restarting in TCP mode port: 5555
6. 找到Android设备的IP地址:设置-->关于手机-->IP地址。记住这个IP地址,像这样组成:#.#.#.#
7.
连接adb到设备
$ adb connect #.#.#.#
connected to #.#.#.#:5555
8.
从设备上移除USB线,确认你还是可以访问设备
$ adb devices
List of devices attached
#.#.#.#:5555 device
现在好了!
如果adb连接永远丢包:
1. 确认你的主机和Android设备连接到了同一个Wifi网络
2. 重新执行adb连接步骤重新连接
3. 如果还是不工作,重启adb服务
adb kill-server
然后从开头执行步骤
更多推荐
Android调试桥
发布评论