Android调试桥

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， 一般情况下，用户级别的APK都会在这里被显示出来的	你可以使用forward jdwp:<pid>， 端口转发连接指定的jdwp进程，例如： adb forward tcp:8000 jdwp:472 jdb -attach localhost:8000 （jdb是一个支持java代码级调试的工具，它是由java jdk提供的，存在于xxx\Java\jdk1.6.0_21\bin之下）
数据	"install <path-to-apk>"	向模拟器或真机安装一个Android应用 （对.apk文件指定全路径）
	"pull <remote> <local>"	拷贝一个指定的文件从模拟器或真机到 开发机
	"push <local> <remote>"	拷贝一个指定的文件从开发机到模拟器 或真机
端口和网络	"forward <local> <remote>"	转发一个socket连接，从指定的本地端口到指定的在模拟器或真机的远端端口	端口指定可以使用这些格式： tcp:<portnum> local:<UNIX domain socket name> dev:<character device name> jdwp:<pid>
	"ppp <tty> [parm]..."	通过USB运行PPP: <tty> — the tty for PPP stream. For example dev:/dev/omap_csmi_ttyl. [parm]... — zero or more PPP/PPPD options, such as defaultroute, local, notty, etc. 注意，你不应该自动启动PPP连接
脚本	"get-serialno"	显示adb连接实例的序列号
	"get-state"	显示模拟器或真机的adb状态
	"wait-for-device"	阻碍执行，直到设备状态是online--当 状态是device	你可以在执行其他adb命令前，执行这个命令，当adb需要等待模拟器或真机连接再发出其他命令时，下面是一个例子： adb wait-for-device shell getprop 注意这个命令不会使adb等待直到系统完全启动。因为这个原因，你不应该在需要等待系统完全启动时，在其他命令前预先执行这个命令。例如：install命令需要Android package manager，它只有在系统完全启动才是可用的。例如如下命令： adb wait-for-device install <app>.apk 当模拟器或真机连接上adb服务端，就会发出install命令，但是当Android系统完全启动前，它将返回错误信息。
服务	"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

   然后从开头执行步骤