用途:自动化执行 ADB 命令,用于 Android 设备管理、应用安装与日志分析,适用于列出设备、安装/卸载 APK、查看应用日志、调试应用问题、截图与录屏等场景。
主要能力:设备管理(adb devices -l 列出设备,adb kill-server && adb start-server 重启服务);应用管理(adb install -r app.apk 安装,adb uninstall com.package.name 卸载,adb shell pm clear 清除数据,adb shell am start -n pkg/.Activity 启动,adb shell am force-stop 强制停止);日志(adb logcat -v threadtime 查看全部,adb logcat --pid=$(adb shell pidof pkg) 仅应用日志,adb logcat -s TAG_NAME 按标签过滤,adb logcat *:E 仅错误,adb logcat -c 清空缓冲);调试(adb exec-out screencap -p > screen.png 截图,adb shell screenrecord /sdcard/video.mp4 录屏,adb pull /data/anr/traces.txt 查看 ANR,adb logcat -b crash 获取崩溃日志)。
使用方式:按需组合命令,例如安装并启动调试包、清数据后重启、监控指定标签日志、导出崩溃日志。多设备时用 adb -s SERIAL_NUMBER shell 指定设备。可结合 Gradle 安装与 CI/CD(如 Firebase Test Lab)流程使用。
限制与注意:设备未找到需在开发者选项启用 USB 调试;安装失败可先卸载冲突版本;权限被拒需 root 或开启调试;未授权需在设备上确认电脑。建议使用过滤日志、用 -d 导出后退出、复现问题前清空 logcat。官方文档与 Logcat 指南可作参考。