1. ADB工具概述与基础配置Android Debug BridgeADB是Android开发中最强大的命令行工具之一它建立了开发机与Android设备之间的通信桥梁。作为一名长期与Android设备打交道的开发者我深刻体会到掌握ADB命令的重要性——它不仅能大幅提升调试效率还能完成许多图形界面无法实现的操作。1.1 ADB组件架构解析ADB采用经典的C/S架构设计包含三个核心组件客户端运行在开发机上通过命令行终端调用守护进程(adbd)在设备后台运行执行实际命令服务器管理客户端与守护进程间的通信这种设计使得我们可以从任意客户端控制所有连接的设备特别适合需要同时管理多台设备的场景。在我的日常工作中经常需要同时连接3-4台测试设备ADB的这种架构设计让设备管理变得非常高效。1.2 环境配置实战要开始使用ADB首先需要配置开发环境安装SDK Platform Tools# 通过Android Studio的SDK Manager安装 $ sdkmanager platform-tools # 或直接下载独立包 $ wget https://dl.google.com/android/repository/platform-tools-latest-linux.zip $ unzip platform-tools-latest-linux.zip配置环境变量 将platform-tools目录加入PATH这是很多新手容易忽略的关键步骤# Linux/macOS $ echo export PATH$PATH:~/android-sdk/platform-tools ~/.bashrc $ source ~/.bashrc # Windows # 在系统环境变量PATH中添加类似路径 # C:\Users\YourName\AppData\Local\Android\Sdk\platform-tools验证安装$ adb version Android Debug Bridge version 1.0.41 Version 34.0.4-10411341提示如果遇到adb: command not found错误99%的情况是环境变量配置不正确。建议仔细检查PATH设置特别是Windows用户要注意路径分隔符使用是否正确。1.3 设备连接与授权连接物理设备时需要开启USB调试模式进入设备设置 → 关于手机 → 连续点击版本号7次激活开发者选项返回设置 → 系统 → 开发者选项 → 启用USB调试通过USB连接电脑后在设备上弹出的RSA密钥对话框中点击确认验证设备连接状态$ adb devices List of devices attached emulator-5554 device ABCDEF123456 device常见连接问题排查设备未显示检查USB线是否支持数据传输尝试更换USB端口设备显示为unauthorized重新插拔USB线并在设备上确认授权连接不稳定尝试使用原装数据线避免使用USB集线器2. 设备管理核心命令2.1 多设备操作技巧当连接多个设备时必须指定目标设备。我最常用的方式是使用-s参数# 获取所有设备列表带详细信息 $ adb devices -l emulator-5554 device product:sdk_gphone64_x86_64 model:Android_SDK_built_for_x86_64 ABCDEF123456 device usb:3-4.4.4 product:raphael model:Redmi_K20_Pro # 针对特定设备执行命令 $ adb -s ABCDEF123456 shell getprop ro.product.model Redmi_K20_Pro对于日常频繁操作同一设备的情况设置环境变量更高效$ export ANDROID_SERIALABCDEF123456 $ adb shell # 此时会自动连接到指定设备2.2 网络连接配置除了USB连接ADB还支持WiFi连接这在需要同时连接多台设备时特别有用Android 11设备无线连接步骤确保设备和电脑在同一网络设备上设置 → 开发者选项 → 无线调试 → 启用选择使用配对码配对记下显示的IP、端口和6位配对码电脑端执行$ adb pair 192.168.1.100:40484 Enter pairing code: 123456 Successfully paired to 192.168.1.100:40484传统设备无线连接方法# 先用USB连接执行 $ adb tcpip 5555 restarting in TCP mode port: 5555 # 断开USB后通过WiFi连接 $ adb connect 192.168.1.100:5555 connected to 192.168.1.100:5555实战经验企业级路由器通常会限制ADB的端口通信。如果连接不稳定建议检查路由器的防火墙设置开放5555端口或关闭AP隔离功能。2.3 设备信息查询快速获取设备详细信息对调试非常有用# 获取设备型号 $ adb shell getprop ro.product.model # 获取Android版本 $ adb shell getprop ro.build.version.release # 获取屏幕分辨率 $ adb shell wm size Physical size: 1080x2340 # 获取CPU信息 $ adb shell cat /proc/cpuinfo # 获取内存信息 $ adb shell cat /proc/meminfo我经常将这些命令组合使用快速建立设备档案$ adb shell echo Model: $(getprop ro.product.model); \ echo OS: $(getprop ro.build.version.release); \ echo Resolution: $(wm size | cut -d -f3); \ echo RAM: $(awk /MemTotal/{print $2/1024MB} /proc/meminfo) Model: Pixel 6 OS: 13 Resolution: 1080x2340 RAM: 5863.66MB3. 应用管理深度实践3.1 应用安装与卸载高级安装技巧# 安装APK并保留数据适用于升级场景 $ adb install -r app-debug.apk # 安装到SD卡需要应用支持 $ adb install -s app-debug.apk # 多用户设备安装Android 5.0 $ adb install --user 10 app-debug.apk # 安装时授予所有权限避免运行时权限弹窗 $ adb install -g app-debug.apk常见安装错误处理INSTALL_FAILED_VERSION_DOWNGRADE添加-d参数强制降级INSTALL_FAILED_UPDATE_INCOMPATIBLE先执行adb uninstall彻底卸载旧版INSTALL_PARSE_FAILED_NO_CERTIFICATESAPK未正确签名批量操作技巧# 卸载所有测试包 $ adb shell pm list packages | grep com.example | cut -d: -f2 | xargs -L1 adb uninstall # 安装目录下所有APK $ find . -name *.apk -exec adb install {} \;3.2 应用调试与分析高级调试命令# 清除应用数据相当于设置中的清除数据 $ adb shell pm clear com.example.app # 强制停止应用 $ adb shell am force-stop com.example.app # 监控应用启动时间 $ adb shell am start -W -n com.example.app/.MainActivity Starting: Intent { cmpcom.example.app/.MainActivity } Status: ok Activity: com.example.app/.MainActivity ThisTime: 245 TotalTime: 245 WaitTime: 250 Complete # 获取应用内存占用 $ adb shell dumpsys meminfo com.example.appActivity管理器高级用法# 带参数启动Activity $ adb shell am start -n com.example.app/.DetailActivity \ --es extra_key extra_value \ --ei int_key 123 # 发送广播 $ adb shell am broadcast -a com.example.action.NOTIFY \ --es message Hello from ADB # 启动服务 $ adb shell am startservice -n com.example.app/.MyService3.3 应用权限管理Android 6.0的运行时权限可以通过ADB管理# 授予单个权限 $ adb shell pm grant com.example.app android.permission.CAMERA # 撤销权限 $ adb shell pm revoke com.example.app android.permission.READ_CONTACTS # 重置所有权限 $ adb shell pm reset-permissions危险权限列表# 查看所有危险权限 $ adb shell pm list permissions -d -g开发提示在Android 10设备上部分权限如MANAGE_EXTERNAL_STORAGE需要特殊处理。如果应用需要访问所有文件除了在清单中声明还需要手动授予权限$ adb shell appops set --uid com.example.app MANAGE_EXTERNAL_STORAGE allow4. 文件操作与系统管理4.1 高效文件传输基础文件操作# 电脑→设备 $ adb push local.txt /sdcard/remote.txt # 设备→电脑 $ adb pull /sdcard/remote.txt ~/Downloads/ # 同步目录保持时间戳 $ adb sync /sdcard/DCIM/ ~/Pictures/Android/高级技巧# 传输时显示进度 $ adb push --progress largefile.zip /sdcard/ # 批量传输特定类型文件 $ adb shell find /sdcard/ -name *.jpg | xargs -I {} adb pull {} ./photos/ # 比较文件差异 $ diff (adb shell cat /system/build.prop) local_build.prop4.2 日志收集与分析基础日志收集# 实时查看日志 $ adb logcat # 按标签过滤 $ adb logcat -s MyAppTag # 按优先级过滤V/D/I/W/E $ adb logcat *:E高级日志技巧# 带时间戳和进程ID $ adb logcat -v threadtime # 清空日志缓冲区 $ adb logcat -c # 将日志写入文件 $ adb logcat -d logcat.txt # 监控ANR错误 $ adb shell cat /data/anr/traces.txt anr_log.txt日志分析管道# 查找崩溃堆栈 $ adb logcat | grep -A 20 -B 5 Crash # 统计错误频率 $ adb logcat | grep E AndroidRuntime | cut -d -f8 | sort | uniq -c | sort -nr4.3 系统级操作设备配置修改# 修改屏幕分辨率临时 $ adb shell wm size 720x1280 # 修改DPI密度 $ adb shell wm density 240 # 恢复默认设置 $ adb shell wm size reset $ adb shell wm density reset电源管理# 保持唤醒状态 $ adb shell svc power stayon true # 模拟电源键 $ adb shell input keyevent 26 # 关机/重启 $ adb reboot $ adb reboot bootloader # 进入fastboot模式 $ adb reboot recovery # 进入recovery模式输入模拟# 点击屏幕(x300,y500) $ adb shell input tap 300 500 # 滑动(从x1,y1到x2,y2持续200ms) $ adb shell input swipe 100 500 100 100 200 # 文本输入 $ adb shell input text Hello%sworld # %s表示空格系统属性操作# 查看所有属性 $ adb shell getprop # 设置临时属性 $ adb shell setprop debug.layout false # 修改build.prop需要root $ adb root $ adb remount $ adb pull /system/build.prop $ sed -i s/ro.debuggable0/ro.debuggable1/ build.prop $ adb push build.prop /system/ $ adb shell chmod 644 /system/build.prop $ adb reboot5. 高级调试技巧与自动化5.1 性能分析工具CPU使用率监控# 查看CPU核心数 $ adb shell cat /proc/cpuinfo | grep processor | wc -l # 实时监控CPU频率 $ adb shell watch -n 1 cat /sys/devices/system/cpu/cpu*/cpufreq/scaling_cur_freq # 按进程查看CPU占用 $ adb shell top -n 1 | head -20内存分析# 查看内存概况 $ adb shell cat /proc/meminfo # 监控内存泄漏 $ adb shell dumpsys meminfo --package com.example.app -d # 生成Java堆转储需要debuggable $ adb shell am dumpheap com.example.app /data/local/tmp/heap.hprof $ adb pull /data/local/tmp/heap.hprof电池状态检查# 获取电池信息 $ adb shell dumpsys battery # 设置充电状态模拟 $ adb shell dumpsys battery set ac 1 # 连接充电器 $ adb shell dumpsys battery set usb 0 # 断开USB充电 # 查询电池循环次数部分设备 $ adb shell dumpsys batterystats | grep cycle5.2 自动化测试Monkey压力测试# 基本随机测试 $ adb shell monkey -p com.example.app 1000 # 带参数的高级测试 $ adb shell monkey -p com.example.app \ --throttle 100 \ --pct-touch 40 \ --pct-motion 25 \ --pct-trackball 5 \ --pct-nav 10 \ --pct-syskeys 5 \ --pct-appswitch 10 \ --pct-anyevent 5 \ -v -v 5000UI自动化# 获取当前Activity $ adb shell dumpsys window | grep mCurrentFocus # 获取UI层级 $ adb shell uiautomator dump /sdcard/window.xml $ adb pull /sdcard/window.xml # 通过坐标点击需先获取元素坐标 $ adb shell input tap x y5.3 脚本化与批处理Windows批处理示例echo off adb devices adb install app-debug.apk adb shell am start -n com.example.app/.MainActivity timeout /t 5 adb logcat -d log_%date:~0,4%%date:~5,2%%date:~8,2%.txtLinux/macOS Shell脚本#!/bin/bash DEVICE$(adb devices | grep -w device | awk {print $1}) if [ -z $DEVICE ]; then echo No device connected! exit 1 fi echo Processing on device: $DEVICE adb -s $DEVICE install app-debug.apk adb -s $DEVICE shell pm list packages | grep com.example adb -s $DEVICE logcat -c adb -s $DEVICE shell am start -n com.example.app/.MainActivity sleep 5 adb -s $DEVICE logcat -d log_$(date %Y%m%d_%H%M%S).txtPython自动化示例import subprocess import re def run_adb_command(cmd): result subprocess.run(fadb {cmd}, shellTrue, capture_outputTrue, textTrue) return result.stdout # 获取设备信息 devices [d.split(\t)[0] for d in run_adb_command(devices).splitlines()[1:] if d.endswith(device)] for device in devices: print(fProcessing device: {device}) run_adb_command(f-s {device} install app-debug.apk) run_adb_command(f-s {device} logcat -c) run_adb_command(f-s {device} shell am start -n com.example.app/.MainActivity)6. 疑难问题解决方案6.1 常见错误处理ADB server问题# 强制重启ADB服务 $ adb kill-server adb start-server # 检查端口占用5037为ADB默认端口 $ lsof -i :5037 $ netstat -ano | findstr 5037 # Windows设备连接问题# 检查USB设备列表 $ lsusb # Linux $ system_profiler SPUSBDataType # macOS权限不足问题# 重新挂载系统分区为可写需要root $ adb root $ adb remount # 修改文件权限 $ adb shell chmod 644 /system/build.prop6.2 高级调试技巧内核日志获取$ adb shell dmesg dmesg.log $ adb shell cat /proc/kmsg kmsg.log 系统事件监控# 监控输入事件 $ adb shell getevent -l # 监控广播 $ adb shell logcat -b events | grep am_broadcastANR分析流程复现ANR问题立即执行$ adb pull /data/anr/traces.txt $ adb shell cat /proc/adb shell pidof com.example.app/task/*/stack stacks.txt检查主线程是否阻塞在锁或IO操作上6.3 性能优化建议启动时间优化# 测量冷启动时间 $ adb shell am start -W -n com.example.app/.MainActivity # 禁用动画获取更准确时间 $ adb shell settings put global window_animation_scale 0 $ adb shell settings put global transition_animation_scale 0 $ adb shell settings put global animator_duration_scale 0内存泄漏排查在可疑操作前后手动触发GC$ adb shell am send-trim-memory com.example.app RUNNING_LOW使用Android Studio的Memory Profiler分析hprof文件比较多次dump的内存快照网络优化检查# 监控网络连接 $ adb shell netstat -tn # 检查DNS解析 $ adb shell getprop net.dns1 # 模拟慢速网络 $ adb shell settings put global http_proxy 127.0.0.1:8080 $ adb reverse tcp:8080 tcp:8080 # 配合Charles等代理工具