Windows环境下Android Studio系列7—ADB

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

1. ADB概述

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

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

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

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

    可以在<sdk>/platform-tools/目录下找到adb.exe工具。

    当启动adb客户端时，客户端首先检测adb服务端进程是否运行，如果没有运行，则启动服务端。当服务端启动时，它会绑定到本地的TCP 5037端口，并且监听从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客户端的命令，所以可以从任何一个客户端或脚本来控制任何模拟器或手机设备。

2. 使能ADB调试

    为了对手机进行adb调试，需要先将手机通过USB连接到开发用的电脑上，然后在手机的 "系统设置"，"开发者选项" 下使能 "USB调试"。

    待补充。。。

3. ADB命令语法

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

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

      如果只有一个模拟器运行或只有一个手机相连，则adb命令缺省发送给这个设备。如果有多个模拟器或手机正在运行，就需要使用-d, -e或-s参数指定要操作的是哪一个。

       -d仅通过USB接口来管理ADB，如果有多个USB接口来管理则返回错误。

       -e仅仅通过模拟器实例来管理ADB，如果有多个模拟器运行则返回错误。

       -s <specific device>通过模拟器/设备的序列号或限定词（qualifier）来发送命令来管理ADB。

4. ADB常用命令

4.1 查看ADB版本

#adb version
Android Debug Bridge version 1.0.32

    注意：当多个客户端公用一个adb server时需要统一客户端的adb版本，否则会造成相互“杀死”对方adb server的情况，可参见[3]。    

4.2 查询模拟器或手机状态

   了解adb服务端连接的模拟器或手机可以帮助更好的使用adb命令，这可以通过devices命令列举出来：

#adb devices [-l]

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

 * 序列号(serialNumber) — 由adb创建的使用控制台端口号的用于唯一标识一个模拟器或手机设备的字符串，格式是 <设备IP地址>:<端口号>，例如： 192.168.238.101:5555

 * 状态(state) — 连接状态，其值是：

 offline — 未连接或未响应

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

每一个设备的输出形如：

 [serialNumber] [state]

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

#adb devices
List of devices attached
192.168.238.101:5555  device

#adb devices -l
List of devices attached
192.168.238.101:5555  device product:vbox86p model:Samsung_Galaxy_S4___4_3___API_18___1080x1920 device:vbox86p

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

还可以通过 #adb get-serialno 和 #adb get-state 分别得到序列号和状态值。

4.3 操作指定的模拟器或手机

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

#adb -s <serialNumber> <command>

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

#adb -s 192.168.238.101:5555 install helloWorld.apk

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

4.4 安装与卸载应用程序

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

#adb install [-r] [-s] <path_to_apk>

      -r表示重新安装该APK包

      -s表示将APK包安装到SD卡上——默认是将APK包安装到内部存储器上。

     

   如果希望从Android系统中删除指定软件包，则可使用如下命令：

#adb uninstall [-k] <package>

   -k表示只删除该应用程序，但保留该程序所用的数据和缓存目录。

4.5 与模拟器或手机传输文件

      可以使用adb的 pull 和 push 命令从模拟器或手机中复制文件，或者将文件复制到模拟器或手机中。与 install 命令不同，它仅能复制.apk文件到特定的位置， pull 和 push 命令可以复制任意文件夹和文件到模拟器或手机的任何位置。

   从模拟器或手机中复制一个文件或文件夹（递归的）使用：

#adb pull <remote> <local>

　　复制一个文件或文件夹（递归的）到模拟器或手机中使用：

#adb push <local> <remote>

　　在这个命令中<local>和<remote>引用的是文件或文件夹的路径，在开发用电脑上的是local，在模拟器或手机上的是remote。

　　例如：

#adb push foo.txt /sdcard/foo.txt

4.6 进入远端Android设备shell以及退出

#adb shell

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

       /system/bin/...    

   无论是否进入adb远程shell，都可以使用 shell 命令来执行，进入远端Android设备后就可以操作Linux系统下的所有东西了。

#exit

4.7 ADB shell中常用命令

    查看用户的adb路径

#which adb

 修改hosts文件

 由于某些原因，可能需要指定域名对应的IP地址。Android是基于Linux的系统，与Linux类似，通过hosts文件来设置。在Android下，/etc是link到/system/etc的，我们需要修改/system/etc/hosts来实现。但是这个文件是只读，不能通过shell直接修改。可以通过连接到PC上使用adb来修改。步骤如下[4]：

1、获得root权限：
  #adb root

2、设置/system为可读写权限：
  #adb remount
  
3、将hosts文件复制到PC：
  #adb pull /system/etc/hosts d:\tmp\hosts
  
4、修改PC机上文件d:\tmp\hosts

5、将PC机上d:\tmp\hosts文件复制到手机：
  #adb push d:\tmp\hosts /system/etc/hosts

   

   Android上的hosts文件必须像以下这样写：

IP 域名

    在IP和域名之间保留一个空格，每行只能有一个域名，不能一个IP后面跟多个域名。

   如果要查看是否修改成功，可以在手机上运行cat /system/etc/hosts，首先检查文件内容是否修改，然后ping一个域名，如果可以ping通则说明hosts文件修改成功。如果ping域名不通，则怀疑是否由于是在windows下修改hosts文件，而没有注意换行符导致的问题，同时还需要注意hosts文件格式问题。

    Android上的换行符(也就是回车)是LF，也就是\n，而windows上的换行符是CR LF，也就是\r\n，所以在Windows下用记事本之类的软件编辑了hosts文件，放到手机上肯定认不出来的！因此即使cats /etc/hosts文件看上去没有问题，但实际ping 域名是无法ping通的。

    解决的办法就是用NotePad++之类的文本编辑器用“视图”-->"显示符号"-->"显示所有字符"来查看，此时可以很明显地看到\r\n字符。再使用“查找替换”，将“\r\n”替换成“\n”（注意要在Notepad++里把查找模式设置为扩展模式，才能识别转义字符\r\n）。同时要保证最后一行结尾也是“\n”。

    ps：如何判断手机是否已经root了，输入adb shell回车, su 回车,如果出现#,那么你的手机的确ROOT了。  

   查看hosts文件

#cat /etc/hosts

   

  查看网络地址

#ifconfig eth0

#ifconfig eth1 // 通常为手机或Genymotion的无线网络地址

5. 源代码阅读

    可参见[5], adb代码位于Android源码树的platform/system/core/adb/目录下，可以通过下面的git命令下载：

git clone git://android.git.kernel.org/platform/system/core.git

    [3]中问题查看和解决就是检查adb_client.c找出问题的。    

6. 参考资料

[1] Android ADB使用之详细篇, http://www.jizhuomi.com/android/environment/191.html

[2] Android Debug Bridge, http://developer.android.com/intl/zh-cn/tools/help/adb.html

[3] Android Debug Bridge(ADB)学习总结, yagami_can, 2013-04-21,  http://www.cnblogs.com/yagami/archive/2013/04/21/3029747.html

[4] Android下修改hosts文件-重启有效, 2011-10-16, http://blog.chinaunix.net/uid-7591044-id-2971870.html

[5] android下修改hosts文件不起作用（无效）的解决办法, 2012-11-27, http://blog.csdn.net/leiming32/article/details/8229305

[6] ADB源码分析（一）, claud, 2011-05-31, http://blog.claudxiao.net/2011/05/adb_analysis_part1/