ADB学习

目录

ADB是什么

ADB架构

ADB端口被占用

基本用法

adb命令语法

启动/停止adb server

查看adb版本

root权限/非root权限运行

设备连接管理

查看设备信息

USB连接

无线连接（需要借助 USB 线）

无线连接（无需借助USB线）

应用管理

查看应用列表

安装apk

卸载应用

清除应用数据与缓存

查看前台Activity

查看正在运行的Services

查看应用详细信息

与应用交互

---

---

ADB是什么

        ADB的全称为Android Debug Bridge：android调试桥梁。我们可以在android sdk安装目录的platform-tools目录下找到adb工具。Android的初衷是用adb这样的一个工具来协助开发人员在开发android应用的过程中更快更好的调试apk，因此adb具有安装卸载apk、拷贝推送文件、查看设备硬件信息、查看应用程序占用资源、在设备执行shell命令等功能。

---

ADB架构

      ADB是一个C/S架构的应用程序，由三部分组成：

1. 运行在pc端的adb client：
   命令行程序”adb”用于从shell或脚本中运行adb命令。首先，“adb”程序尝试定位主机上的ADB服务器，如果找不到ADB服务器，“adb”程序自动启动一个ADB服务器。接下来，当设备的adbd和pc端的adb server建立连接后，adb client就可以向ADB servcer发送服务请求；
2. 运行在pc端的adb server：
   ADB Server是运行在主机上的一个后台进程。它的作用在于检测USB端口感知设备的连接和拔除，以及模拟器实例的启动或停止，ADB Server还需要将adb client的请求通过usb或者tcp的方式发送到对应的adbd上；
3. 运行在设备端的常驻进程adb demon (adbd)：
   程序“adbd”作为一个后台进程在Android设备或模拟器系统中运行。它的作用是连接ADB服务器，并且为运行在主机上的客户端提供一些服务

---

ADB端口被占用

"""
5037为adb默认端口，若5037端口被占用，则我们在使用Adb命令的时候会因为找不到设备而困扰
解决思路：
1.找到使用该端口的进程Pid
2.通过PID找到对应的进程名（便于定位，可以跳过）
3.使用命令终止该命令的运行
"""

# 1.找到使用该端口的进程Pid
netstat -aon|findstr 5037

# 2.通过PID找到对应的进程名（便于定位，可以跳过）
tasklist /fi "PID eq xxxx"

# 3.使用命令终止该命令的运行
taskkill /pid xxxx /f

---

基本用法

adb命令语法

adb [-d|-e|-s <设备序列号>] <子命令>
"""
-d ：指定当前唯一通过USB连接的Android设备为命令目标
-e ：指定当前唯一运行的模拟器为命令目标
-s ：<serialNumber>指定相应serialNumber号(简称SN号)的设备/模拟器为命令目标
"""

# 给指定设备安装apk
adb -s deviceSN install xxx.apk

启动/停止adb server

# 停止adb server命令
adb kill-server

# 启动adb server命令
adb start-server

# 指定adb server的网络端口
adb -P <port> start-server
# 默认端口为5037

查看adb版本

adb version

root权限/非root权限运行

# adb的运行原理是PC端的adb server与手机端的守护进程adbd建立连接，然后PC端的adb client通过adb server转发命令，adbd接收命令后解析运行。所以如果adbd以普通权限执行，有些需要root权限才能执行的命令无法直接用adb xxx执行。这时可以adb shell然后su后执行命令，也可以让adbd以root权限执行，这个就能随意执行高权限命令了


# 让adbd以root权限执行
adb root
# 输出：restarting adbd as root
# 再次运行adb shell 命令提示符变由"$"变为"#"

# 恢复adbd为非root权限
adb unroot
# 再次运行adb shell 命令提示符变由"#"变为"$"

---

设备连接管理

查看设备信息

adb devices
"""
输出格式为： [serialNumber] [state]
# serialNumber：设备的SN号
# state：设备状态
"""

"""
输出示例:
List of devices attached
cf264b8f	device
emulator-5554	device
10.129.164.6:5555	device
"""

"""
从输出的SN号可以大概判断设备类型及连接方式
1. 类似cf264b8f                             USB连接手机
2. 类似emulator-5554                        Android模拟器
3. 类似10.129.164.6:5555形为：的             无线连接的设备或Genymotion等第三方Android模拟器
"""

# 查看设备状态
adb get-state
"""
state有如下几种：
1. offline：表示设备未连接成功或无响应
2. device：设备已连接。注意这个状态并不能标识Android系统已经完全启动和可操作，在设备启动过程中设备实例就可连接到adb，但启动完毕后系统才处于可操作状态
3. no device：没有设备/模拟器连接
"""

USB连接

"""
前置条件：
1. 硬件状态正常：
   Android设备处于正常开机状态，USB连接线和各种接口完好
   Android设备的开发者选项和USB调试模式已开启
2. 设备驱动状态正常：
   在Linux和Mac OS X下不用操心
   在 Windows 下有可能遇到需要安装驱动的情况，确认这一点可以右键「计算机」-「属性」，到「设备管理器」里查看相关设备上是否有黄色感叹号或问号，如果没有就说明驱动状态已经好了
"""

# 确认连接状态
adb devices
#输出xxxxxx device说明连接成功

无线连接（需要借助 USB 线）

"""
操作步骤
1.将 Android 设备与要运行 adb 的电脑连接到同一个局域网，比如连到同一个 WiFi
2.将设备与电脑通过 USB 线连接
3.应确保连接成功（可运行adb devices看是否能列出该设备）
4.让设备在 5555 端口监听TCP/IP连接
5.断开USB连接
6.找到设备的 IP 地址:一般能在「设置」-「关于手机」-「状态信息」-「IP地址」找到，也可以用adb命令
7.通过 IP 地址连接设备
8.确认连接状态
"""

# 4.让设备在5555端口监听TCP/IP连接
adb tcpip 5555

# 6.查看设备的IP地址
adb shell ifconfig "| grep Mask"
"""
输出示例：
inet addr:10.130.245.230  Mask:255.255.255.252
inet addr:127.0.0.1  Mask:255.0.0.0
设备 IP 地址就是：10.130.245.230 
"""

# 7.通过 IP 地址连接设备
adb connect <device-ip-address>

# 8.确认连接状态
adb devices
# 输出结果：<device-ip-address>:5555 device说明连接成功

无线连接（无需借助USB线）

"""
前置条件：需要root权限
"""

"""
操作步骤：
1.在 Android 设备上安装一个终端模拟器，已经安装过的设备可以跳过此步。我使用的终端模拟器下载地址是：Terminal Emulator for Android Downloads
2.将 Android 设备与要运行 adb 的电脑连接到同一个局域网，比如连到同一个 WiFi
3.打开 Android 设备上的终端模拟器，执行两条命令
4.找到Android设备的IP地址，一般能在「设置」-「关于手机」-「状态信息」-「IP地址」找到，也可以使用adb命令来查看
5.在电脑上通过adb和IP地址连接Android设备，并确认连接成功
注：
*6.有的设备可能在第5步之前，需要在设备的终端模拟器上重启adbd服务
"""
# 3.打开 Android 设备上的终端模拟器，执行两条命令
su
setprop service.adb.tcp.port 5555

# 4.找到Android设备的IP地址
adb shell ifconfig "| grep Mask"
"""
输出示例：
inet addr:10.130.245.230  Mask:255.255.255.252
inet addr:127.0.0.1  Mask:255.0.0.0
设备 IP 地址就是：10.130.245.230 
"""

# 5.在电脑上通过adb和IP地址连接Android设备
adb connect <device-ip-address>
#输出结果：connected to :5555则说明连接成功

# *6.有的设备可能在第5步之前，需要在设备的终端模拟器上重启adbd服务
restart adbd
# 如果restart无效，请尝试以下命令
stop adbd
start adbd

---

应用管理

查看应用列表

# 查看应用列表的基本命令格式
adb shell pm list packages [-f] [-d] [-e] [-s] [-3] [-i] [-u] [--user USER_ID] [FILTER]
"""
过滤参数：
无 ： 所有应用
-f : 显示应用关联的apk文件
-d : 只显示disabled（禁用/关闭）的应用
-e : 只显示enabled（启用）的应用
-s : 只显示系统应用
-3 : 只显示第三方应用
-i : 显示应用的installer
-u : 包含已卸载应用
<FILTER（过滤器）> : 包名包含<FILTER>字符串
"""

# 查看所有应用
adb shell pm list packages

# 查看系统应用
adb shell pm list packages -s

# 查看第三方应用
adb shell pm list packages -3

# 查看包名包含zi的应用列表
adb shell pm list packages zi
# 也可以使用grep过滤(linux环境下)
adb shell pm list packages | grep zi
# 也可以使用findstr过滤（Windows环境下）
adb shell pm list packages | findstr zi

安装apk

adb install [-lrtsdpg] <apkpath>
"""
-l ：锁定应用程序
-r : 覆盖原安装文件，保存数据
-t ：允许测试包
-s : 把应用程序安装到sd卡上
-d ：允许降级覆盖安装，也就是安装的比手机上带的版本低
-p ：部分应用安装
-g ：为应用程序授予所有运行时的权限
"""

# 默认安装
adb install "path\xxx.apk"

# 指定设备安装
adb -s deviceSN install "path\xxx.apk"

# -r 覆盖安装，使用场景：提示[INSTALL_FAILED_ALREADY_EXISTS],说明已经有同样的应用被安装
adb install -r "path\xxx.apk"

# -t 允许测试包,使用场景：提示[INSTALL_FAILED_TEST_ONLY]，说明这个apk并不是正式的版本，所以不能直接被安装在手机上
adb install -t "path\xxx.apk"

# -s 把应用程序安装到sd卡上
adb install -s "path\xxx.apk"

# -d 允许降级覆盖安装，使用场景：提示[INSTALL_FAILED_VERSION_DOWNGRADE]，说明你要装的apk版本还没有手机里的高

# 命令可以混用
# 在指定设备的sd卡降级覆盖安装apk
adb -s deviceSN install -s -t "path\xxx.apk"

"""
adb install 内部原理简介

adb install 实际是分三步完成：
1.push apk 文件到 /data/local/tmp。
2.调用 pm install 安装。
3.删除 /data/local/tmp 下的对应 apk 文件。
所以，必要的时候也可以根据这个步骤，手动分步执行安装过程。
"""

常见安装失败输出代码、含义及可能的解决办法

输出

含义

解决办法

INSTALL_FAILED_ALREADY_EXISTS

应用已经存在，或卸载了但没卸载干净

adb install 时使用 -r 参数，或者先 adb uninstall <packagename> 再安装

INSTALL_FAILED_INVALID_APK

无效的 APK 文件

INSTALL_FAILED_INVALID_URI

无效的 APK 文件名

确保 APK 文件名里无中文

INSTALL_FAILED_INSUFFICIENT_STORAGE

空间不足

清理空间

INSTALL_FAILED_DUPLICATE_PACKAGE

已经存在同名程序

INSTALL_FAILED_NO_SHARED_USER

请求的共享用户不存在

INSTALL_FAILED_UPDATE_INCOMPATIBLE

以前安装过同名应用，但卸载时数据没有移除；或者已安装该应用，但签名不一致

先 adb uninstall <packagename> 再安装

INSTALL_FAILED_SHARED_USER_INCOMPATIBLE

请求的共享用户存在但签名不一致

INSTALL_FAILED_MISSING_SHARED_LIBRARY

安装包使用了设备上不可用的共享库

INSTALL_FAILED_REPLACE_COULDNT_DELETE

替换时无法删除

INSTALL_FAILED_DEXOPT

dex 优化验证失败或空间不足

INSTALL_FAILED_OLDER_SDK

设备系统版本低于应用要求

INSTALL_FAILED_CONFLICTING_PROVIDER

设备里已经存在与应用里同名的 content provider

INSTALL_FAILED_NEWER_SDK

设备系统版本高于应用要求

INSTALL_FAILED_TEST_ONLY

应用是 test-only 的，但安装时没有指定 -t 参数

INSTALL_FAILED_CPU_ABI_INCOMPATIBLE

包含不兼容设备 CPU 应用程序二进制接口的 native code

INSTALL_FAILED_MISSING_FEATURE

应用使用了设备不可用的功能

INSTALL_FAILED_CONTAINER_ERROR

1. sdcard 访问失败;
2. 应用签名与 ROM 签名一致，被当作内置应用。

1. 确认 sdcard 可用，或者安装到内置存储;
2. 打包时不与 ROM 使用相同签名

INSTALL_FAILED_INVALID_INSTALL_LOCATION

1. 不能安装到指定位置;
2. 应用签名与 ROM 签名一致，被当作内置应用。

1. 切换安装位置，添加或删除 -s 参数;
2. 打包时不与 ROM 使用相同签名

INSTALL_FAILED_MEDIA_UNAVAILABLE

安装位置不可用

一般为 sdcard，确认 sdcard 可用或安装到内置存储

INSTALL_FAILED_VERIFICATION_TIMEOUT

验证安装包超时

INSTALL_FAILED_VERIFICATION_FAILURE

验证安装包失败

INSTALL_FAILED_PACKAGE_CHANGED

应用与调用程序期望的不一致

INSTALL_FAILED_UID_CHANGED

以前安装过该应用，与本次分配的 UID 不一致

清除以前安装过的残留文件

INSTALL_FAILED_VERSION_DOWNGRADE

已经安装了该应用更高版本

使用 -d 参数

INSTALL_FAILED_PERMISSION_MODEL_DOWNGRADE

已安装 target SDK 支持运行时权限的同名应用，要安装的版本不支持运行时权限

INSTALL_PARSE_FAILED_NOT_APK

指定路径不是文件，或不是以 .apk 结尾

INSTALL_PARSE_FAILED_BAD_MANIFEST

无法解析的 AndroidManifest.xml 文件

INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION

解析器遇到异常

INSTALL_PARSE_FAILED_NO_CERTIFICATES

安装包没有签名

INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES

已安装该应用，且签名与 APK 文件不一致

先卸载设备上的该应用，再安装

INSTALL_PARSE_FAILED_CERTIFICATE_ENCODING

解析 APK 文件时遇到 CertificateEncodingException

INSTALL_PARSE_FAILED_BAD_PACKAGE_NAME

manifest 文件里没有或者使用了无效的包名

INSTALL_PARSE_FAILED_BAD_SHARED_USER_ID

manifest 文件里指定了无效的共享用户 ID

INSTALL_PARSE_FAILED_MANIFEST_MALFORMED

解析 manifest 文件时遇到结构性错误

INSTALL_PARSE_FAILED_MANIFEST_EMPTY

在 manifest 文件里找不到找可操作标签（instrumentation 或 application)

INSTALL_FAILED_INTERNAL_ERROR

因系统问题安装失败

INSTALL_FAILED_USER_RESTRICTED

用户被限制安装应用

INSTALL_FAILED_DUPLICATE_PERMISSION

应用尝试定义一个已经存在的权限名称

INSTALL_FAILED_NO_MATCHING_ABIS

应用包含设备的应用程序二进制接口不支持的 native code

INSTALL_CANCELED_BY_USER

应用安装需要在设备上确认，但未操作设备或点了取消

在设备上同意安装

INSTALL_FAILED_ACWF_INCOMPATIBLE

应用程序与设备不兼容

does not contain AndroidManifest.xml

无效的 APK 文件

is not a valid zip file

无效的 APK 文件

Offline

设备未连接成功

先将设备与 adb 连接成功

unauthorized

设备未授权允许调试

error: device not found

没有连接成功的设备

先将设备与 adb 连接成功

protocol failure

设备已断开连接

先将设备与 adb 连接成功

Unknown option: -s

Android 2.2 以下不支持安装到 sdcard

不使用 -s 参数

No space left on device

空间不足

清理空间

Permission denied … sdcard …

sdcard 不可用

signatures do not match the previously installed version; ignoring!

已安装该应用且签名不一致

先卸载设备上的该应用，再安装

卸载应用

adb uninstall [-k] <packagename>

"""
-k : 表示卸载应用但保留数据和缓存目录
<packagename> : 表示应用的包名
"""

清除应用数据与缓存

adb shell pm clear <packagename>

"""
<packagename> : 表示应用名包
这条命令的效果相当于在设置里的应用信息界面点击了「清除缓存」和「清除数据」
"""

查看前台Activity

adb shell dumpsys activity activities | grep mFocusedActivity
"""
输出示例：
mFocusedActivity: ActivityRecord{8079d7e u0 com.cyanogenmod.trebuchet/com.android.launcher3.Launcher t42}
其中的 com.cyanogenmod.trebuchet/com.android.launcher3.Launcher 就是当前处于前台的 Activity
"""

查看正在运行的Services

adb shell dumpsys activity services [<packagename>]
"""
<packagename> 参数不是必须的，指定 <packagename> 表示查看与某个包名相关的 Services，不指定表示查看所有 Services
<packagename> 不一定要给出完整的包名，比如运行 adb shell dumpsys activity services org.mazhuang，那么包名 org.mazhuang.demo1、org.mazhuang.demo2 和 org.mazhuang123 等相关的 Services 都会列出来
"""

查看应用详细信息

adb shell dumpsys package <packagename>
"""
输出中包含很多信息，包括 Activity Resolver Table、Registered ContentProviders、包名、userId、安装后的文件资源代码等路径、版本信息、权限信息和授予状态、签名版本信息等
<packagename> 表示应用包名
"""

与应用交互