ADB 命令帮助文档中文翻译

ADB 命令帮助文档中文翻译

基本信息

Android Debug Bridge 版本 1.0.39

版本 1:8.1.0+r23-5~18.04

安装路径：/usr/lib/android-sdk/platform-tools/adb

---

全局选项

选项	说明
-a	监听所有网络接口，而不仅仅是 localhost
-d	使用 USB 设备（当有多个设备连接时，使用 USB 设备）
-e	使用 TCP/IP 设备（当有多个 TCP/IP 设备可用时，使用 TCP/IP 设备）
-s SERIAL	使用指定序列号的设备（覆盖 $ANDROID_SERIAL 环境变量）
-t ID	使用指定传输 ID 的设备
-H	ADB 服务器主机名 默认=localhost
-P	ADB 服务器端口 默认=5037
-L SOCKET	监听给定的套接字作为 ADB 服务器 默认=tcp:localhost:5037

---

通用命令

命令	说明
devices [-l]	列出已连接的设备（-l 显示详细信息）
help	显示此帮助信息
version	显示版本号

---

网络相关

命令	说明
connect HOST[:PORT]	通过 TCP/IP 连接到设备 默认端口=5555
disconnect [HOST[:PORT]]	断开与指定 TCP/IP 设备的连接，或断开所有连接
forward --list	列出所有转发套接字连接
forward [--no-rebind] LOCAL REMOTE	转发套接字连接，支持类型： • tcp:<端口> • localabstract:<Unix域套接字名称> • localreserved:<Unix域套接字名称> • localfilesystem:<Unix域套接字名称> • dev:<字符设备名称> • jdwp:<进程PID>（仅远程）
forward --remove LOCAL	删除指定的转发套接字连接
forward --remove-all	删除所有转发套接字连接
ppp TTY [参数...]	通过 USB 运行 PPP
reverse --list	列出设备上的所有反向套接字连接
reverse [--no-rebind] REMOTE LOCAL	反向套接字连接，支持类型同上
reverse --remove REMOTE	删除指定的反向套接字连接
reverse --remove-all	删除所有反向套接字连接

---

文件传输

命令	说明
push [--sync] 本地文件... 远程路径	将本地文件/目录复制到设备 --sync：仅推送主机上比设备更新的文件
pull [-a] 远程文件... 本地路径	从设备复制文件/目录 -a：保留文件时间戳和权限
`sync [system	vendor

---

Shell 相关

命令	说明
shell [-e 转义字符] [-n] [-Tt] [-x] [命令...]	运行远程 shell 命令（无命令时进入交互式 shell） -e：选择转义字符，或 "none"；默认 '~' -n：不从标准输入读取 -T：禁用 PTY 分配 -t：强制 PTY 分配 -x：禁用远程退出码和 stdout/stderr 分离
emu 命令	运行模拟器控制台命令

---

应用安装

命令	说明
install [-lrtsdg] 包名	推送包到设备并安装
install-multiple [-lrtsdpg] 包名...	推送多个包到设备并安装
安装选项
-l	锁定应用程序（转发锁定）
-r	替换现有应用程序
-t	允许测试包
-s	安装到 SD 卡
-d	允许版本降级（仅限可调试包）
-p	部分应用安装（仅 install-multiple）
-g	授予所有运行时权限
uninstall [-k] 包名	从设备移除应用包 -k：保留数据和缓存目录

---

备份/恢复

命令	说明
adb shell bu help	显示备份/恢复帮助信息

---

调试相关

命令	说明
bugreport [路径]	生成错误报告到指定路径 默认=bugreport.zip 如果路径是目录，错误报告保存在该目录中 不支持压缩错误报告的设备输出到标准输出
jdwp	列出托管 JDWP 传输的进程 PID
logcat	显示设备日志（logcat --help 查看更多）

---

安全相关

命令	说明
disable-verity	在 userdebug 版本上禁用 dm-verity 检查
enable-verity	在 userdebug 版本上重新启用 dm-verity 检查
keygen 文件	生成 adb 公钥/私钥；私钥存储在文件中，公钥存储在 文件.pub 中（现有文件将被覆盖）

---

脚本相关

命令	说明
wait-for[-TRANSPORT]-STATE	等待设备进入指定状态 状态：device, recovery, sideload, bootloader 传输类型：usb, local, any 默认=any
get-state	输出设备状态（offline | bootloader | device）
get-serialno	输出序列号
get-devpath	输出设备路径
remount	重新挂载 /system、/vendor 和 /oem 分区为读写模式
`reboot [bootloader	recovery
sideload OTA包	加载指定的完整 OTA 包
root	以 root 权限重启 adbd
unroot	以非 root 权限重启 adbd
usb	重启 ADB 服务器监听 USB
tcpip 端口	重启 ADB 服务器监听 TCP 指定端口

---

内部调试

命令	说明
start-server	确保 ADB 服务器正在运行
kill-server	如果 ADB 服务器正在运行则终止它
reconnect	从主机端断开连接，强制重新连接
reconnect device	从设备端断开连接，强制重新连接
reconnect offline	重置离线/未授权设备，强制重新连接

---

环境变量

变量	说明
$ADB_TRACE	逗号分隔的调试信息列表：all,adb,sockets,packets,rwx,usb,sync,sysdeps,transport,jdwp
$ADB_VENDOR_KEYS	冒号分隔的密钥列表（文件或目录）
$ANDROID_SERIAL	要连接的设备序列号（见 -s 选项）
$ANDROID_LOG_TAGS	logcat 使用的标签（见 logcat --help）

---

常用命令示例

查看设备

adb devices                    # 列出所有连接的设备
adb devices -l                 # 显示详细信息（含设备型号）

安装应用

adb install app.apk            # 安装应用
adb install -r app.apk         # 覆盖安装
adb install -s app.apk         # 安装到 SD 卡

文件传输

adb push local.txt /sdcard/    # 推送文件到设备
adb pull /sdcard/remote.txt ./  # 从设备拉取文件

进入设备 Shell

adb shell                      # 进入交互式 shell
	exit					   # 退出交互式 shell
adb shell ls /sdcard           # 执行单条命令

日志查看

adb logcat                     # 查看实时日志
adb logcat -c                  # 清空日志缓冲区

网络调试

adb tcpip 5555                 # 重启 ADB 为 TCP 模式
adb connect 192.168.1.100:5555 # 通过 WiFi 连接设备

应用管理

adb uninstall com.example.app  # 卸载应用
adb uninstall -k com.example.app # 卸载但保留数据

调试相关

adb bugreport bugreport.zip    # 生成错误报告
adb reboot                     # 重启设备
adb reboot bootloader          # 重启到 bootloader
adb reboot recovery            # 重启到 recovery

分区操作

adb remount                    # 重新挂载为可读写
adb disable-verity             # 禁用 dm-verity

---

提示

• 部分命令（如 remount、disable-verity）需要在 root 权限 下运行
• 使用 -s 参数可以指定多设备环境下的目标设备
• wait-for-device 常用于脚本中等待设备连接