Android开发环境中,ADB是我们进行Android开发经常要用的调试工具,它的使用当然是我们Android开发者必须要掌握的。

一. ADB概述

Android Debug Bridge,Android调试桥接器,简称adb,是用于管理模拟器或真机状态的万能工具,采用了客户端-服务器模型,包括三个部分:

1. 客户端部分,运行在开发用的电脑上,可以在命令行中运行adb命令来调用该客户端,像ADB插件和DDMS这样的Android工具也可以调用adb客户端。

2. 服务端部分,是运行在开发用电脑上的后台进程,用于管理客户端与运行在模拟器或真机的守护进程通信。

3. 守护进程部分,运行于模拟器或手机的后台。

当启动adb客户端时,客户端首先检测adb服务端进程是否运行,如果没有运行,则启动服务端。当服务端启动时,它会绑定到本地的TCP5037端口,并且监听从adb客户端发来的命令——所有的adb客户端都使用5037端口与adb服务端通信。

接下来服务端与所有正在运行的模拟器或手机连接。它通过扫描5555-5585之间的奇数号端口来搜索模拟器或手机,一旦发现adb守护进程,就通过此端口进行连接。需要说明的是,每一个模拟器或手机使用一对有序的端口,偶数号端口用于控制台连接,奇数号端口用于adb连接,例如:

Emulator 1, console: 5554
Emulator 1, adb: 5555
Emulator 2, console: 5556
Emulator 2, adb: 5557 ...

即如果模拟器与adb在5555端口连接,则其与控制台的连接就是5554端口。

当服务端与所有的模拟器建立连接之后,就可以使用adb命令来控制或者访问了。因为服务端管理着连接并且可以接收到从多个adb客户端的命令,所以可以从任何一个客户端或脚本来控制任何模拟器或手机设备。

下文介绍了可以用来管理模拟器或手机的这些adb命令。如果是在Eclipse并且安装了ADT插件的环境下开发Android应用程序,就不需要从命令行使用adb了,ADT插件已经提供了透明的集成。不过,还是可以在调试等需要的时候直接使用adb。

二. 如何找到adb

安装夜神模拟器后,电脑桌面会有“夜神模拟器”的启动图标,鼠标右键--打开文件所在的位置,就会进入***\Nox\bin,比如小编的路径是C:\Program Files (x86)\Nox\bin,然后可以在该路径下找到nox_adb.exe

三. 如何连接设备?

首先需要进入\Nox\bin路径的cmd窗口。

方式一:继续上述的步骤,进入\Nox\bin目录,然后按Shift键的同时,单击鼠标右键,就会看到“在此处打开命令窗口(W)”,点击即可进入\Nox\bin路径的cmd窗口。

方式二:按Windows+R键,在弹出的“运行”窗口输入cmd,确定,然后输入cd C:\Program Files (x86)\Nox\bin(说明:这是你的夜神模拟器安装路径),即可。说明:如果你的夜神模拟器不是安装在C盘,比如安装在D盘,请在cd前面先输入D: 然后按回车键,再cd ...\Nox\bin。

在连接设备之前,先查看一下在运行的设备:

nox_adb.exe devices

C:\Program Files (x86)\Nox\bin>nox_adb devices

List of devices attached

127.0.0.1:62001 device

说明:nox_adb.exe 完全等同于nox_adb,也完全等同于adb,下同。比如adb devices。

如果未启动夜神模拟器,就会得到如下信息:

C:\Program Files (x86)\Nox\bin>adb devices

List of devices attached

(这一行是空的,需要我们先把夜神模拟器启动一下)

如果启动的模拟器不止一个,如果连接设备?

比如小编多开了3个夜神模拟器,adb devices一下,会看到如下信息:

C:\Program Files (x86)\Nox\bin>nox_adb devices

List of devices attached

127.0.0.1:62001 device

127.0.0.1:62025 device

127.0.0.1:62026 device

 注:夜神模拟器的端口是规律的,第一个模拟器端口是62001,第二个模拟器端口是62025,第三个是62025+1,以此类推)

如果指定在62001 上安装一个apk,那么请输入:adb -s 127.0.0.1:62001 install D:\\QQ.apk

温馨提示:adb -s 127.0.0.1:620** 可连接任意指定的设备,多开模拟器后想怎么连都可以,为方便教程,以下操作都是在单开模拟器下进行,如果多开需要,只需要在adb后面带上-s 127.0.0.1:620** 即可。

四. 如何使用adb命令?

从开发用电脑的命令行或脚本文件中使用adb命令的用法是:

adb [-d|-e|-s <serialNumber>] <command>

当使用的时候,程序会调用adb客户端。因为adb客户端不需要关联到任何模拟器,所以如果有多个模拟器或手机正在运行,就需要使用-d参数指定要操作的是哪一个。

五. 常用adb操作介绍

1. 如何把电脑上的文件或文件夹传到模拟器里面?

adb push D:/sex.avi /mnt/avi/

2. 如何把模拟器里面的文件或文件夹传到电脑上?

adb pull /mnt/avi/sex.avi D:/avi/

3. 安装APK

adb install d:\\qq.apk

4. 卸载APK

adb uninstall 包名

比如卸载QQ:adb uninstall com.tencent.mobileqq

5. PM包命令

(1)获取模拟器所有包名

adb shell pm list packages

(2)获取模拟器所有包名并且包括APK路径

adb shell pm list packages -f

(3)获取包名对应的APK路径

adb shell pm path packageName

(4) 清理应用数据

adb shell pm clear packageName

6. 启动应用

adb shell am start -n 包名/Activity类名

例子:启动应用宝:

adb shell am start -n com.tencent.android.qqdownloader/com.tencent.assistant.activity.SplashActivity

7. 指定模拟器启动动应用宝:

adb -s 127.0.0.1:5555 shell am start -n com.tencent.android.qqdownloader/com.tencent.assistant.activity.SplashActivity

8. 关闭应用

adb shell am force-stop 包名

9. 模拟输入

adb shell input text 字符串(不支持中文)

10. 模拟按键

adb shell input keyevent 键值

11. 模拟鼠标点击

adb shell input tap X Y

12. 模拟鼠标滑动

adb shell input swipe X1 Y1 X2 Y2

13. 截屏

adb shell screencap -p /sdcard/screencap.png

14. 设置手机IMEI/IMSI/手机号/SIM卡序列号

adb shell setprop persist.nox.modem.imei 352462010682470

adb shell setprop persist.nox.modem.imsi 460000000000000

adb shell setprop persist.nox.modem.phonumber 15605569000

adb shell setprop persist.nox.modem.serial 89860000000000000000

15. nox_adb shell进去然后执行下面的命令修改经纬度

setprop persist.nox.gps.latitude xxx

setprop persist.nox.gps.longitude xxx

16. 修改mac地址

setprop persist.nox.wifimac xxx                  修改mac地址

setprop persist.nox.modem.phonumber 138111111111       手机号,生成一个随机11位数字

setprop persist.nox.model ABC001                  手机型号,英文加数字随机

setprop persist.nox.manufacturer XiaoMi             手机制造商英文随机

setprop persist.nox.brand Mi                    手机品牌英文随机

17. 打印log信息

adb logcat

指令

说明

备注

adb logcat

打印log

/

adb logcat -c

清除手机的log buffer

有些手机权限控制, 不支持.

adb logcat -b <buffer>

打印指定buffer的log信息

buffer有: main(主log区,默认), events(事件相关的log), radio(射频, telephony相关的log)

adb logcat -v <format>

格式化输出log

常用的用adb logcat -v time显示时间

adb logcat -f <filename>

输出log到指定文件

 

18. 启动/杀死adb简介中提到的Server端进程

由于adb并不稳定, 有时候莫名的问题掉线时, 可以先kill-server, 然后start-server来确保Server进程启动。往往可以解决问题。

adb start/kill-server

19. 执行一些系统动作

例如启动指定activity, 结束进程, 发送广播, 更改屏幕属性等. 调试利器

adb shell am

指令

说明

备注

start <Intent>

根据intent指向启动Activity

Intent可以是显示的指向activity, 也可以是ACTION方式, 并且可以添加flag, data等参数信息.

startservice <Intent>

启动Service

可以添加flag, data等参数信息.

broadcast <Intent>

发送广播

可以添加flag, data等参数信息.

monitor

启动一个Crash和ANR的监听器

如有Crash或ANR会在控制台输出相关信息.

force-stop <Package>

强制停止该包相关的一切

传入package name.

kill <Package>

杀死该包相关的所有进程

传入package name.

kill-all

杀死所有后台进程

 

display-size WxH

改变显示的分辨率

例如adb shell am display-size 1280x720, 手机可能不支持.

display-density <dpi>

改变显示的density

例如adb shell am display-density 320, 手机可能不支持.


20. adb shell dumpsys

强大的dump工具, 可以输出很多系统信息. 例如window, activity, task/back stack信息, wifi信息等.

常用dumpsys:

指令

说明

备注

细分参数

activity

输出app组件相关信息

还可以用细分参数获得单项内容, 下同. 例如adb shell dumpsys activity activities来获取activity task/back stack信息.

activites, service, providers, intents, broadcasts, processes

alarm

输出当前系统的alarm信息

/

/

cpuinfo

输出当前的CPU使用情况

/

/

diskstats

输出当前的磁盘使用状态

/

/

batterystats

电池使用信息

/

/

package

package相关信息, 相当于pm功能的集合

输出诸如libs, features, packages等信息

/

meminfo

输出每个App的内存使用和系统内存状态

可以指定包名, 例如adb shell dumpsys meminfo com.anly.githubapp

/

window

输出当前窗口相关信息

/

policy, animator, tokens, windows

21. 复制  

-copy:<nox_id> _from:<nox_id>

例:Nox.exe -copy:Nox_1 -from:nox

Nox_1是新增的模拟器,复制自nox

22. 删除  

-remove:<nox_id>

例:Nox.exe -remove:Nox_2

删除模拟器Nox_2

23. 备份

 -backup:<nox_id> -file:filepath

例:Nox.exe -backup:Nox_1 -file:C:\Users\xxxx\Desktop  

备份Nox_1到桌面

24. 还原  

-restore:<nox_id> -file:filepath

例:Nox.exe -restore:Nox_1 -file:C:\xxxx\lihc\Desktop\backup20171030174008.vmdk

[C:\Users\xxxx\Desktop\backup20171030174008.vmdk]文件还原到Nox_1

 25. 查询模拟器或手机状态

adb devices

执行结果是adb为每一个设备输出以下状态信息:

26. 序列号(serialNumber) 

由adb创建的使用控制台端口号的用于唯一标识一个模拟器或手机设备的字符串,格式是 <设备类型>-<端口号>,例如: emulator-5554

27. 状态(state) 

连接状态,其值是:

offline:未连接或未响应

device:已经连接到服务商。注意这个状态并不表示Android系统已经完全启动起来,系统启动的过程中已经可以连接adb,但这个状态是正常的可操作状态。

下面是 devices 命令和其执行结果:

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

如果没有模拟器或手机在运行,该状态返回的是no device。

28. 操作指定的模拟器或手机

如果有多个模拟器或手机正在运行,当使用adb命令的时候就需要指定目标设备,这可以通过使用-s选项参数实现,用法是:

adb -s <serialNumber> <command>

即可以在adb命令中使用序列号指定特定的目标,前文已经提到的devices命令可以实现查询设备的序列号信息。

例如:adb -s emulator-5556 install helloWorld.apk

需要注意的是,如果使用了-s而没有指定设备的话,adb会报错。

29. 安装应用程序

可以使用adb从开发用电脑中复制应用程序并且安装到模拟器或手机上,使用install命令即可,在这个命令中,必须指定待安装的.apk文件的路径:

adb install <path_to_apk>

关于创建可安装的应用的更多信息,请参见Android Asset Packaging Tool (aapt)。

注意,如果使用了安装有ADT插件的Eclipse开发环境,就不需要直接使用adb或aapt命令来安装应用程序了,ADT插件可以自动完成这些操作。

30. 转发端口

可以使用forward 命令转发端口 — 将特定端口上的请求转发到模拟器或手机的不同的端口上。下例是从6100端口转到7100端口:

adb forward tcp:6100 tcp:7100

也可以使用UNIX命名的socket标识:

adb forward tcp:6100 local:logd

六. adb命令列表

类别

命令

说明

备注

可选项

-d

命令仅对USB设备有效

如果有多个USB设备就会返回错误

-e

命令仅对运行中的模拟器有效

如果有多个运行中的模拟器就会返回错误

 
-s <serialNumber>

命令仅对adb关联的特定序列号的模拟器或手机有效(例如 "emulator-5556").

如果不指定设备就会返回错误

 
一般项devices

输出所有关联的模拟器或手机设备列表

参见 Querying for Emulator/Device Instances 以获得更多信息。

help

输出adb支持的命令

  
version

输出adb的版本号

  

调试项

logcat [<option>] [<filter-specs>]

在屏幕上输出日志信息

 

bugreport

为报告bug,在屏幕上输出dumpsys, dumpstate和 logcat数据

  

jdwp

输出有效的JDWP进程信息

可以使用 forward jdwp:<pid> 转换端口以连接到指定的 JDWP 进程,例如:

adb forward tcp:8000 jdwp:472

jdb -attach localhost:8000

 

数据项

install <path-to-apk>

安装应用程序(用完整路径指定.apk文件)

 

pull <remote> <local>

从开发机COPY指定的文件到模拟器或手机

  

push <local> <remote>

从模拟器或手机COPY文件到开发机

  

端口和网络项

forward <local> <remote>

从本地端口转换连接到模拟器或手机的指定端口

端口可以使用以下格式表示:

l  tcp:<portnum>

l  local:<UNIX domain socket name>

l  dev:<character device name>

l  jdwp:<pid>

ppp <tty> [parm]...

通过USB运行UPP

l  <tty> —PPP流中的tty。例如:/dev/omap_csmi_ttyl。

l  [parm]... — 0到多个PPP/PPPD 选项, 例如 defaultroute, local, notty等等。

注意不用自动启动PPP连接

  

脚本项

get-serialno

输出adb对象的序列号

参见 Querying for Emulator/Device Instances以获得更多信息。

get-state

输出adb设备的状态

  

wait-for-device

阻塞执行直到设备已经连接,即设备状态是 device.

可以在其他命令前加上此项,那样的话adb就会等到模拟器或手机设备已经连接才会执行命令。

注意该命令并不等待系统完全启动,因此不能追加需要在系统完全启动才能执行的命令,例如install命令需要Android包管理器支持,但它必须在系统完全启动后才有效。

在模拟器或手机与adb发生连接后就执行install,会由于系统还没有完全启动而会引起错误。

 

服务端项

start-server

检测adb服务进程是否启动,如果没启动则启动它。

 

kill-server

终止服务端进程

  

Shell

shell

在目标模拟器或手机上启动远程SHELL

参见 Issuing Shell Commands以获得更多信息。

shell [<shellCommand>]

在目标模拟器或手机上执行shellCommand然后退出远程SHELL  

七. 执行Shell命令

Adb提供了shell来在模拟器或手机上运行各种各样的命令,这些命令的二进制形式存在于这个路径中:

 /system/bin/...    无论是否进入adb远程shell,都可以使用 shell 命令来执行。

在未进入远程shell的情况下可以按下述格式执行单条命令:

adb [-d|-e|-s {<serialNumber>}] shell <shellCommand>   

启动远程shell使用下面的格式:

adb [-d|-e|-s {<serialNumber>}] shell

退出远程shell时使用CTRL+D 或 exit 终止会话。

以下是可以使用的shell命令的更多信息。

(1)从远程shell检查sqlite3数据库

通过远程shell,可以使用sqlite3命令行程序来管理由应用程序创建的SQLite数据库。 sqlite3 工具包含很多有用的命令,例如 .dump 用于输出表格的内容,.schema 用于为已经存在的表输出 SQL CREATE 语句。 并且该工具也提供了联机执行SQLite命令的能力。

使用 sqlite3时,向前文描述的那样进入模拟器的远程shell,然后使用sqlite3 命令。也可以在调用 sqlite3时指定数据库的全路径。SQLite3数据库存储在/data/data/<package_name>/databases/路径下。

示例:

$ adb -s emulator-5554 shell
# sqlite3 /data/data/com.example.google.rss.rssexample/databases/rssitems.db
SQLite version 3.3.12
Enter ".help" for instructions
.... enter commands, then quit...
sqlite> .exit

一旦运行了 sqlite3,就可以使用 sqlite3 命令,退出并返回远程shell可以使用 exit 或 CTRL+D。

(2)使用Monkey进行UI或应用程序测试

Monkey是运行于模拟器或手机上的一个程序,通过生成伪随机的大量的系统级的用户事件流来模拟操作,包括单击、触摸、手势等。从而为正在开发中的应用程序通过随机响应进行压力测试。

最简单使用monkey的方式是通过下面的命令行,它可以运行指定的应用程序并向其发送500个伪随机事件。

$ adb shell monkey -v -p your.package.name 500

关于monkey更多的选项及详细信息,请参见UI/Application Exerciser Monkey。

八. 其他Shell命令

下表列出了很多有效的adb shell命令,完整的列表可以通过启动模拟器并且使用adb –help命令获取。

adb shell ls /system/bin   

帮助对于大部分命令是有效的。

Shell 命令

描述

备注

dumpsys

在屏幕上显示系统数据

The Dalvik Debug Monitor Service(DDMS) 工具提供了更易于使用的智能的调试环境。

dumpstate

将状态输出到文件

 

logcat [<option>]... [<filter-spec>]...

输出日志信息 

dmesg

在屏幕上输出核心调试信息

 

start

启动或重新启动模拟器或手机

 

stop

停止模拟器或手机

 


九. 使用logcat查看日志

Android日志系统提供了从众多应用程序和系统程序中收集和查看调试信息的机制,这些信息被收集到一系统循环缓冲区中,可以 logcat 命令查看和过滤。

(1)使用logcat 命令

查看和跟踪系统日志缓冲区的命令logcat的一般用法是:

[adb] logcat [<option>] ... [<filter-spec>] ...

下文介绍过滤器和命令选项,详细内容可参见Listing of logcat Command Options。

可以在开发机中通过远程shell的方式使用logcat命令查看日志输出:

$ adb logcat

如果是在远程shell中可直接使用命令:

# logcat

(2)过滤日志输出

每一条日志消息都有一个标记和优先级与其关联。标记是一个简短的字符串,用于标识原始消息的来源 (例如"View" 来源于显示系统)。优先级是下面的字符,顺序是从低到高:

V — 明细 (最低优先级)

D — 调试

I — 信息

W — 警告

E — 错误

F — 严重错误

S — 无记载 (最高优先级,没有什么会被记载)

通过运行logcat ,可以获得一个系统中使用的标记和优先级的列表,观察列表的前两列,给出的格式是<priority>/<tag>

这里是一个日志输出的消息,优先级是“I”,标记是“ActivityManager”:

I/ActivityManager(  585): Starting activity: Intent { action=android.intent.action...}

如果想要减少输出的内容,可以加上过滤器表达式进行限制,过滤器可以限制系统只输出感兴趣的标记-优先级组合。

过滤器表达式的格式是tag:priority ... ,其中tag是标记, priority是最小的优先级, 该标记标识的所有大于等于指定优先级的消息被写入日志。也可以在一个过滤器表达式中提供多个这样的过滤,它们之间用空格隔开。

下面给出的例子是仅输出标记为“ActivityManager”并且优先级大于等于“Info”和标记为“MyApp”并且优先级大于等于“Debug”的日志:

adb logcat ActivityManager:I MyApp:D *:S

上述表达式最后的 *:S 用于设置所有标记的日志优先级为S,这样可以确保仅有标记为“View”(译者注:应该为ActivityManager,原文可能是笔误)和“MyApp”的日志被输出,使用 *:S 是可以确保输出符合指定的过滤器设置的一种推荐的方式,这样过滤器就成为了日志输出的“白名单”。

下面的表达是显示所有优先级大于等于“warning”的日志:

adb logcat *:W

如果在开发用电脑上运行 logcat  (相对于运行运程shell而言),也可以通过ANDROID_LOG_TAGS环境变量设置默认的过滤器表达式:

export ANDROID_LOG_TAGS="ActivityManager:I MyApp:D *:S"

需要注意的是,如果是在远程shell或是使用adb shell logcat 命令运行logcat , ANDROID_LOG_TAGS 不会导出到模拟器或手机设备上。

(3)控制日志格式

日志消息在标记和优先级之外还有很多元数据字段,这些字段可以通过修改输出格式来控制输出结果,-v 选项加上下面列出的内容可以控制输出字段:

brief — 显示优先级/标记和原始进程的PID (默认格式)

process — 仅显示进程PID

tag — 仅显示优先级/标记

thread — 仅显示进程:线程和优先级/标记

raw — 显示原始的日志信息,没有其他的元数据字段

time — 显示日期,调用时间,优先级/标记,PID

long —显示所有的元数据字段并且用空行分隔消息内容

可以使用 -v启动 logcat来控制日志格式:

[adb] logcat [-v <format>]

例如使用 thread 输出格式:

adb logcat -v thread

注意只能在 -v 选项中指定一种格式。

(4)Viewing Alternative Log Buffers

Android日志系统为日志消息保持了多个循环缓冲区,而且不是所有的消息都被发送到默认缓冲区,要想查看这些附加的缓冲区,可以使用-b 选项,以下是可以指定的缓冲区:

radio — 查看包含在无线/电话相关的缓冲区消息

events — 查看事件相关的消息

main — 查看主缓冲区 (默认缓冲区)

(5)-b 选项的用法

[adb] logcat [-b <buffer>]

例如查看radio缓冲区:

adb logcat -b radio

(6)查看stdout和stderr

默认的,Android系统发送 stdout 和 stderr (System.out 和 System.err) 输出到 /dev/null。 在 Dalvik VM进程,可以将输出复制到日志文件,在这种情况下,系统使用 stdout 和 stderr标记写入日志,优先级是I。

要想使用这种方式获得输出,需要停止运行中的模拟器或手机,然后使用命令 setprop 来允许输出重定位,示例如下:

$ adb shell stop
$ adb shell setprop log.redirect-stdio true
$ adb shell start

系统会保留这一设置直到模拟器或手机退出,也可以在设备中增加/data/local.prop以使得这一设备成为默认配置

 十. Logcat命令选项列表

选项

描述

-b <buffer>

加载不同的缓冲区日志,例如 event 或radio。main 缓冲区是默认项,参见Viewing Alternative Log Buffers.

-c

清空(刷新)所有的日志并且退出

-d

在屏幕上输出日志并退出

-f <filename>

将日志输出到文件<filename>,默认输出是stdout.

-g

输出日志的大小

-n <count>

设置最大的循环数据<count>,默认是4,需要-r选项

-r <kbytes>

每<kbytes>循环日志文件,默认是16,需要 -f 选项

-s

设置默认的过滤器为无输出

-v <format>

设置输出格式,默认的是brief,支持的格式列表参见Controlling Log Output Format.