简介这是面向 Android 开发与测试人员的 ADB 平台工具包版本 r28.0.1适用于 Windows 环境。借助其中的 ADB 命令行工具开发者可完成设备连接与管理、APK 安装卸载、文件上传下载、日志抓取、shell 访问及多设备并行调试是应用部署和故障排查的常用基础组件。整个压缩包共 782 个文件解压后约 5.9MB除 adb.exe 等核心可执行文件外还包含大量 Python、JavaScript、CSS、HTML 与 Markdown 文件多用于 systrace 性能追踪、结果解析和页面展示同时附有 manifest、license、properties 等配置元数据目录结构完整。资源目前已有 545 人学习下载。相比仅仅获取单个 adb.exe这份打包保留了 platform-tools 的官方目录布局可直接融入 Android SDK 使用便于开发者在日常调试、性能分析和问题定位中获得完整工具链支持。1. platform-tools_r28.0.1-windows一个版本号暴露了它的年纪也暴露了它的用途platform-tools_r28.0.1-windows 是 Android SDK 平台工具在 Windows 上的压缩包解压即是 adb、fastboot 等几个可执行文件。跟动辄几个 GB 的完整 IDE 相比它小到能随手塞进 U 盘却是真机调试、抓崩溃日志、刷机救砖的主力。r28.0.1 大概对应 Android 9 时代的工具链放在今天不算新我在老旧机型和 OEM 定制系统上反而更愿意固定用这套老工具因为新版本在某些设备上会遇到驱动识别和授权协议变化翻车概率比想象中高。这篇文章就从部署开始把高频命令、刷机链路和典型故障一次讲清。2. Windows 上部署 28.0.1解压、PATH 配置与第一次识别设备2.1 先认清压缩包里的文件哪些常用哪些放着就好解压后能看到的核心成员是 adb.exe、fastboot.exe还有 AdbWinApi.dll 和 AdbWinUsbApi.dll 这两个动态库。很多人会犯一个低级错误只把 adb.exe 复制到其他目录结果一运行就报“无法启动缺少 AdbWinApi.dll”。这两个 dll 是 adb 在 Windows 下的 USB 通信依赖必须和 exe 留在同一目录不要自作聪明单独挪文件。sqlite3.exe 是附赠的数据库客户端需要查看应用私有数据库时可以直接打开 db 文件也算实用。dmtracedump.exe、hprof-conv.exe、etc1tool.exe 属于性能分析与图形工具日常调试基本吃灰。选型层面有个问题值得想清楚IDE 里内置的 adb 用着挺方便为什么还要单独留一套 platform-tools真实原因是 IDE 的 adb 版本会随更新自动变化今天能用的命令明天行为就变了排障时版本不一致是最让人头疼的黑匣子。单独固定 28.0.1命令输出都可复现适合自动化脚本和需要稳定环境的场景。压缩包里还有个 source.properties记录了这套工具的构建信息怀疑 adb 被替换或路径冲突时先打开它确认版本别只看 exe 文件日期。2.2 把 platform-tools 加进 PATH一劳永逸的配置方式解压位置建议用简短无空格的路径比如 C 盘根目录下的 platform-tools 目录。打开系统环境变量编辑窗口在用户变量 Path 中新增这个目录。注意加的是目录本身不是 adb.exe 文件路径否则命令无法解析。配置完成后必须新开一个 cmd 窗口旧窗口不会刷新环境变量这是新手最容易踩的坑。REM 新开 cmd 后验证配置是否生效 adb version如果提示“不是内部或外部命令”先检查是否真的开了新窗口再检查 Path 路径是否写错。临时不想改系统变量时可以用下面这条命令在当前窗口生效REM 仅为当前 cmd 窗口添加 PATH关闭后失效 set PATH%PATH%;C:\platform-tools这条命令只对当前窗口有效关闭即失效适合借别人电脑临时用一下。界面配置和临时命令的差别在于持久性项目里如果多人协作建议把解压路径和 PATH 配置写进团队文档避免每台设备重复踩坑。2.3 第一次连接真机adb devices 的前置条件与状态解读真机连电脑前先打开手机开发者选项里的 USB 调试。不同系统进入开发者选项的方式略有差异但基本是连续点击版本号若干次这个操作在 r28.0.1 时代和现在没有区别。数据线连接后手机会弹出“允许 USB 调试吗”的 RSA 密钥指纹授权窗口点击允许并勾选始终允许。这里有个常见翻车点不小心点了取消之后 adb devices 一直显示 unauthorized只能拔线重插或去开发者选项里撤销授权再试。REM 列出当前连接的 adb 设备及状态 adb devices正常输出分两行第一行是 List of devices attached第二行是设备序列号加状态。看到 device 说明通道已通看到 unauthorized 说明授权没确认看到 offline 说明连接不稳定这个问题后面专门讲。如果列表是空的大概率问题出在驱动层打开设备管理器看到未知设备或带感叹号的条目就需要安装对应机型的 USB 驱动。Windows 10 之后对多数新设备能自动匹配驱动但老机型经常匹配失败只能找 OEM 提供的驱动包不建议用万能驱动那反而是玄学问题的高发区。3. adb 高频命令实战装包、看日志、传文件这三件事够用一天3.1 安装 APKinstall 的参数含义与覆盖安装的正确姿势开发调试中最频繁的操作就是装包。adb install 直接安装 APK命令本质是调用安装服务参数决定了遇到冲突时的处理方式。最常用的组合是REM 覆盖安装并允许安装 testOnly 的包 adb install -r -t app-debug.apk-r 表示覆盖安装且保留应用数据适合迭代调试时不清数据直接装新版-t 允许安装带 testOnly 标记的测试包很多构建工具打出的 debug 包都带这个标记不加 -t 会直接安装失败。还有两个参数偶尔用到-s 将应用安装到共享存储多分区设备上意义不大-d 允许降级安装前提是签名一致且目标版本低于当前版本。REM 完全卸载后重新安装解决签名冲突 adb uninstall com.example.demo adb install app-debug.apk为什么签名冲突时要先卸载再装因为 -r 只允许同签名覆盖新旧包签名不一致时系统会拒绝更新报 INSTALL_FAILED_UPDATE_INCOMPATIBLE。这是 debug 签名和 release 签名切换时的经典事故现场。遇到这种情况没有后悔药卸载必然丢应用数据所以团队内要统一签名策略别让测试机变成签名试验田。3.2 日志抓取logcat 的过滤、清空与落盘抓崩溃日志是定位疑难 Bug 的第一步但很多新手只会对着满屏日志发呆。logcat 的默认输出包含系统所有进程的日志量非常大必须学会过滤。Windows 的 cmd 里可以用 findstr 做关键字筛选adb logcat -v time | findstr AndroidRuntime-v time 让每条日志带上时间戳方便和崩溃时间对齐findstr 相当于 Linux 下的 grep过滤包含 AndroidRuntime 的行崩溃堆栈基本都会走这个 tag 输出。更精确的过滤用 -s 指定 tag 和级别比如只看某个模块的 Error 日志adb logcat -v time -s MyApp:* AndroidRuntime:E这里的语法是 tag:级别* 代表任意级别E 只显示 Error多个条件用空格隔开。抓现场的正确顺序是先清空再复现REM 清空历史日志从零开始记录 adb logcat -c REM 操作手机复现问题后落盘到本地文件 adb logcat -v time bug.txt-c 清空历史日志让新日志从零开始重定向到本地文件后用 CtrlC 结束抓取。血泪经验抓日志前先确认设备时间和电脑时间一致否则拿到日志对不上问题发生时间排查效率直接减半。3.3 push 和 pull文件传输的路径与权限边界真机调试经常要在电脑和设备之间交换文件。push 是从电脑推送到设备pull 是从设备拉到电脑adb push ./config.json /sdcard/ adb pull /sdcard/screen.mp4 ./backup/设备端路径用 /sdcard/ 开头这是应用共享存储的标准位置。本地路径用相对路径时注意当前工作目录就是 cmd 所在位置别想当然认为是桌面。设备端路径含空格或中文时要加引号。很多应用把数据放在 /data/data/ 包名目录下普通版本直接 ls 会报 Permission denied这个限制不是 adb 的问题而是 Android 应用沙箱机制。需要导出应用私有数据时调试版本可以用 run-asadb shell run-as com.example.demo ls files/ adb shell run-as com.example.demo cat files/config.xmlrun-as 只在应用是 debug 包时可用的限制让它在生产版本上完全失效这也是为什么很多调试方案要求专门安装 debug 包。文件传输不只是拷数据也是绕过 UI 直接改配置的快捷通道掌握 push 和 pull 能省掉大量手工操作。4. fastboot 刷机链路bootloader 分区表和 A/B 槽位一次讲清4.1 adb 与 fastboot两条互不相通的调试通道adb 跑在系统启动之后依赖 Android 的调试服务fastboot 跑在 bootloader 阶段比系统层更底层。两者使用完全不同的驱动和协议这个认知能避免大量困惑。在系统里执行下面命令进入 bootloaderadb reboot bootloader手机关机后可以尝试音量下加电源键组合进入但不同设备组合键不一样最可靠的方式还是先保证 adb 可用然后用命令切换。进入 bootloader 后 adb devices 就失效了必须用 fastboot 枚举fastboot devices正常会显示设备序列号和 fastboot 字样部分设备显示 ????? 加 fastboot这通常是 bootloader 阶段驱动未匹配或 USB 枚举未完成的信号。fastboot 通道的驱动和 adb 驱动不是一个东西Windows 下经常出现“adb 能连fastboot 找不到设备”的情况排查思路看下一节。4.2 分区与镜像对应关系刷的时候到底在写哪里刷机之前先建立分区概念。一张完整的系统镜像会拆成多个分区镜像常见的是 boot.img、recovery.img、system.img。boot 分区存放内核和启动 ramdiskrecovery 是独立恢复系统system 是只读系统分区。刷镜像就是把这些镜像写到对应分区REM 刷入 boot 和 recovery 分区 fastboot flash boot boot.img fastboot flash recovery recovery.img REM 清除用户数据分区相当于恢复出厂设置 fastboot erase userdataerase 清除用户数据分区刷完通常要执行一次避免旧数据干扰新系统。vendor 分区存放厂商专属库文件非必要不要动bootloader 分区这类更底层分区刷错就直接变砖没有后悔药。所以刷机前先用 getvar 确认分区情况fastboot getvar current-slot fastboot getvar allgetvar 是查询 fastboot 运行环境变量的命令current-slot 返回当前激活的槽位all 列出全部变量。A/B 设备存在两个系统槽位 a 和 b分区名带后缀如 boot_a、boot_b。刷机如果不带后缀部分设备会同时写入两个槽位或直接报错。切换槽位用fastboot set_active b fastboot reboot注意getvar 查询的是 fastboot 环境变量不是系统属性以设备返回值为准。部分设备对变量名大小写敏感建议先 getvar all 看清楚再操作。切换槽位在升级验证场景里很实用把新系统刷入备用槽位从备用槽启动测试失败还能切回原槽位相当于给自己留了一条后悔路。4.3 解锁 bootloader清数据、验签拦截与老工具的能力边界刷入非官方镜像前通常需要解锁 bootloader。解锁命令因设备方案而异常见的是 fastboot flashing unlock 或 fastboot oem unlock。执行后设备会进入确认界面用音量键选择并确认。解锁的代价是强制清除所有用户数据这是安全机制没有绕过的空间。做这一步前把 /sdcard 里的照片和重要文件先 pull 出来REM 把整个共享存储拉回本地防止解锁清空数据 adb pull /sdcard/ ./backup_full/28.0.1 的 fastboot 能力覆盖到 Android 9 左右的设备没有问题但新机型引入了动态分区和新的刷机模式老版本 fastboot 对某些命令会报 unknown command。判断原则很简单先查分区存在性再刷别拿老工具硬怼新分区方案。5. platform-tools 28.0.1 避坑指南5 个典型故障的现象、原因与排查5.1 设备显示 offline过一会儿又变 device现象adb devices 里序列号后面是 offline不拔线的情况下状态反复横跳。原因最常见的是 adb server 残留着旧版本服务Windows 下多开几个开发工具时尤其严重其次是 USB 口供电不稳老台式机前置 USB 口特别容易触发。解决先重启 adb 服务再观察。REM 杀掉旧 adb server 进程并重新启动 adb kill-server adb start-server adb devices这一步能解决大部分 server 层面的问题。如果还是 offline换线换口测试优先用 USB 2.0 后置口。还不行就在设备管理器里卸载该设备驱动重新插拔让系统重装驱动。5.2 驱动装了adb 还是找不到设备现象设备管理器里没有问号但 adb devices 列表为空。原因手机 USB 模式停在“仅充电”调试服务没有暴露给电脑或者 OEM 驱动与当前系统版本不匹配。解决先在手机的 USB 配置里切换到“文件传输”模式不同系统叫法不同可能是 MTP 或“传输文件”然后拔插一次数据线。驱动层面确认设备管理器里出现的是 ADB Interface 而不是“便携设备”后者说明走的还是 MTP 协议adb 依然不可用。老设备在较新系统上装不上驱动时只能走禁用驱动程序强制签名的方式临时安装装完记得把强制签名恢复否则后续装其他驱动会遇到一堆莫名其妙的问题。5.3 fastboot 报 unknown partition 或 not found现象执行 fastboot flash system system.img返回 unknown partition。原因设备分区名和默认印象不一致。A/B 设备实际分区名是 system_a 或 system_b动态分区设备把 system、vendor 等合并进 super 分区老工具链不识别这套新结构。解决先查询分区再决定怎么刷REM 查询指定分区是否存在 fastboot getvar partition-type:system_a fastboot getvar partition-type:superpartition-type: 前缀用于查询指定分区的类型返回有效值说明该分区存在。对 A/B 设备分区名后面补上 _a对动态分区设备28.0.1 的 fastboot 已经力不从心直接换新版 platform-tools或按设备方案进入对应的刷机模式。5.4 覆盖安装报 INSTALL_FAILED_UPDATE_INCOMPATIBLE现象adb install -r 安装新版 APK直接报签名冲突。原因新旧 APK 签名不一致系统拒绝用新签名覆盖旧签名的应用。常见于同一台测试机上 debug 包和 release 包混装。解决签名不一致只能先卸载REM 卸载旧应用数据会一并清除 adb uninstall com.example.demo adb install app-release.apk卸载必然丢失应用数据这个操作不可逆。预防办法是给测试机固定使用同一套签名debug 包和 release 包分开设备验证别挤在同一台机器上。5.5 刷机过程全成功但开机卡在品牌 logo现象fastboot 刷入全部镜像后重启长时间停留在开机界面。原因刷入的 boot 镜像与系统版本不匹配或者只刷了 boot 没刷对应 system内核与系统版本不一致导致无法启动。解决先刷回官方完整镜像的 boot 和 system确认能正常开机再考虑其他方案REM 刷回官方 boot 和 system 分区 fastboot flash boot boot.img fastboot flash system system.imgsystem.img 如果是稀疏镜像部分老版本 fastboot 写入会异常优先使用官方提供的非稀疏镜像。开不了机时别急着说变砖只要 bootloader 和 recovery 还在就能反复重刷真正危险的是手滑刷错 bootloader 分区。6. 让 28.0.1 继续够用无线调试、多设备分流与老工具的边界6.1 无线调试摆脱数据线的三条命令手机连上同一局域网后先用 USB 开启无线调试端口REM 开启无线调试端口 adb tcpip 5555 adb connect 192.168.1.100:5555tcpip 5555 让设备在 5555 端口监听 adb 连接connect 后面跟设备在局域网里的 IP。执行成功后 adb devices 里会出现 IP 加端口号的条目USB 线就可以拔了。注意一点电脑端 adb server 重启后无线连接不会自动恢复重新 connect 一次就行不用重新插线。6.2 多设备分流与版本锁定两个值得固化的习惯同时挂着多台设备时命令会提示设备不唯一这时用 -s 指定设备序列号adb -s 设备序列号 shell脚本里先执行 adb devices 拿全部序列号再对每个序列号执行 -s 操作就能批量跑。同型号多台设备只靠序列号容易认错建议在开发者选项里把设备名改成任务代号拉日志时用设备名做文件名前缀。最后说版本锁定的习惯。常有开发者把 28.0.1 和系统里另一个 adb 混着用折腾半宿才发现是两套版本输出格式不一样。我的习惯是每个项目在文档里写明所用 platform-tools 的确切版本脚本开头加一个版本断言维护老旧设备时就固定用 28.0.1遇到新设备新分区方案果断换新版不让情怀耽误进度。这个习惯帮我避开了不少低级返工希望帮到你。本文还有配套的精品资源点击获取
简介这是面向 Android 开发与测试人员的 ADB 平台工具包版本 r28.0.1适用于 Windows 环境。借助其中的 ADB 命令行工具开发者可完成设备连接与管理、APK 安装卸载、文件上传下载、日志抓取、shell 访问及多设备并行调试是应用部署和故障排查的常用基础组件。整个压缩包共 782 个文件解压后约 5.9MB除 adb.exe 等核心可执行文件外还包含大量 Python、JavaScript、CSS、HTML 与 Markdown 文件多用于 systrace 性能追踪、结果解析和页面展示同时附有 manifest、license、properties 等配置元数据目录结构完整。资源目前已有 545 人学习下载。相比仅仅获取单个 adb.exe这份打包保留了 platform-tools 的官方目录布局可直接融入 Android SDK 使用便于开发者在日常调试、性能分析和问题定位中获得完整工具链支持。1. platform-tools_r28.0.1-windows一个版本号暴露了它的年纪也暴露了它的用途platform-tools_r28.0.1-windows 是 Android SDK 平台工具在 Windows 上的压缩包解压即是 adb、fastboot 等几个可执行文件。跟动辄几个 GB 的完整 IDE 相比它小到能随手塞进 U 盘却是真机调试、抓崩溃日志、刷机救砖的主力。r28.0.1 大概对应 Android 9 时代的工具链放在今天不算新我在老旧机型和 OEM 定制系统上反而更愿意固定用这套老工具因为新版本在某些设备上会遇到驱动识别和授权协议变化翻车概率比想象中高。这篇文章就从部署开始把高频命令、刷机链路和典型故障一次讲清。2. Windows 上部署 28.0.1解压、PATH 配置与第一次识别设备2.1 先认清压缩包里的文件哪些常用哪些放着就好解压后能看到的核心成员是 adb.exe、fastboot.exe还有 AdbWinApi.dll 和 AdbWinUsbApi.dll 这两个动态库。很多人会犯一个低级错误只把 adb.exe 复制到其他目录结果一运行就报“无法启动缺少 AdbWinApi.dll”。这两个 dll 是 adb 在 Windows 下的 USB 通信依赖必须和 exe 留在同一目录不要自作聪明单独挪文件。sqlite3.exe 是附赠的数据库客户端需要查看应用私有数据库时可以直接打开 db 文件也算实用。dmtracedump.exe、hprof-conv.exe、etc1tool.exe 属于性能分析与图形工具日常调试基本吃灰。选型层面有个问题值得想清楚IDE 里内置的 adb 用着挺方便为什么还要单独留一套 platform-tools真实原因是 IDE 的 adb 版本会随更新自动变化今天能用的命令明天行为就变了排障时版本不一致是最让人头疼的黑匣子。单独固定 28.0.1命令输出都可复现适合自动化脚本和需要稳定环境的场景。压缩包里还有个 source.properties记录了这套工具的构建信息怀疑 adb 被替换或路径冲突时先打开它确认版本别只看 exe 文件日期。2.2 把 platform-tools 加进 PATH一劳永逸的配置方式解压位置建议用简短无空格的路径比如 C 盘根目录下的 platform-tools 目录。打开系统环境变量编辑窗口在用户变量 Path 中新增这个目录。注意加的是目录本身不是 adb.exe 文件路径否则命令无法解析。配置完成后必须新开一个 cmd 窗口旧窗口不会刷新环境变量这是新手最容易踩的坑。REM 新开 cmd 后验证配置是否生效 adb version如果提示“不是内部或外部命令”先检查是否真的开了新窗口再检查 Path 路径是否写错。临时不想改系统变量时可以用下面这条命令在当前窗口生效REM 仅为当前 cmd 窗口添加 PATH关闭后失效 set PATH%PATH%;C:\platform-tools这条命令只对当前窗口有效关闭即失效适合借别人电脑临时用一下。界面配置和临时命令的差别在于持久性项目里如果多人协作建议把解压路径和 PATH 配置写进团队文档避免每台设备重复踩坑。2.3 第一次连接真机adb devices 的前置条件与状态解读真机连电脑前先打开手机开发者选项里的 USB 调试。不同系统进入开发者选项的方式略有差异但基本是连续点击版本号若干次这个操作在 r28.0.1 时代和现在没有区别。数据线连接后手机会弹出“允许 USB 调试吗”的 RSA 密钥指纹授权窗口点击允许并勾选始终允许。这里有个常见翻车点不小心点了取消之后 adb devices 一直显示 unauthorized只能拔线重插或去开发者选项里撤销授权再试。REM 列出当前连接的 adb 设备及状态 adb devices正常输出分两行第一行是 List of devices attached第二行是设备序列号加状态。看到 device 说明通道已通看到 unauthorized 说明授权没确认看到 offline 说明连接不稳定这个问题后面专门讲。如果列表是空的大概率问题出在驱动层打开设备管理器看到未知设备或带感叹号的条目就需要安装对应机型的 USB 驱动。Windows 10 之后对多数新设备能自动匹配驱动但老机型经常匹配失败只能找 OEM 提供的驱动包不建议用万能驱动那反而是玄学问题的高发区。3. adb 高频命令实战装包、看日志、传文件这三件事够用一天3.1 安装 APKinstall 的参数含义与覆盖安装的正确姿势开发调试中最频繁的操作就是装包。adb install 直接安装 APK命令本质是调用安装服务参数决定了遇到冲突时的处理方式。最常用的组合是REM 覆盖安装并允许安装 testOnly 的包 adb install -r -t app-debug.apk-r 表示覆盖安装且保留应用数据适合迭代调试时不清数据直接装新版-t 允许安装带 testOnly 标记的测试包很多构建工具打出的 debug 包都带这个标记不加 -t 会直接安装失败。还有两个参数偶尔用到-s 将应用安装到共享存储多分区设备上意义不大-d 允许降级安装前提是签名一致且目标版本低于当前版本。REM 完全卸载后重新安装解决签名冲突 adb uninstall com.example.demo adb install app-debug.apk为什么签名冲突时要先卸载再装因为 -r 只允许同签名覆盖新旧包签名不一致时系统会拒绝更新报 INSTALL_FAILED_UPDATE_INCOMPATIBLE。这是 debug 签名和 release 签名切换时的经典事故现场。遇到这种情况没有后悔药卸载必然丢应用数据所以团队内要统一签名策略别让测试机变成签名试验田。3.2 日志抓取logcat 的过滤、清空与落盘抓崩溃日志是定位疑难 Bug 的第一步但很多新手只会对着满屏日志发呆。logcat 的默认输出包含系统所有进程的日志量非常大必须学会过滤。Windows 的 cmd 里可以用 findstr 做关键字筛选adb logcat -v time | findstr AndroidRuntime-v time 让每条日志带上时间戳方便和崩溃时间对齐findstr 相当于 Linux 下的 grep过滤包含 AndroidRuntime 的行崩溃堆栈基本都会走这个 tag 输出。更精确的过滤用 -s 指定 tag 和级别比如只看某个模块的 Error 日志adb logcat -v time -s MyApp:* AndroidRuntime:E这里的语法是 tag:级别* 代表任意级别E 只显示 Error多个条件用空格隔开。抓现场的正确顺序是先清空再复现REM 清空历史日志从零开始记录 adb logcat -c REM 操作手机复现问题后落盘到本地文件 adb logcat -v time bug.txt-c 清空历史日志让新日志从零开始重定向到本地文件后用 CtrlC 结束抓取。血泪经验抓日志前先确认设备时间和电脑时间一致否则拿到日志对不上问题发生时间排查效率直接减半。3.3 push 和 pull文件传输的路径与权限边界真机调试经常要在电脑和设备之间交换文件。push 是从电脑推送到设备pull 是从设备拉到电脑adb push ./config.json /sdcard/ adb pull /sdcard/screen.mp4 ./backup/设备端路径用 /sdcard/ 开头这是应用共享存储的标准位置。本地路径用相对路径时注意当前工作目录就是 cmd 所在位置别想当然认为是桌面。设备端路径含空格或中文时要加引号。很多应用把数据放在 /data/data/ 包名目录下普通版本直接 ls 会报 Permission denied这个限制不是 adb 的问题而是 Android 应用沙箱机制。需要导出应用私有数据时调试版本可以用 run-asadb shell run-as com.example.demo ls files/ adb shell run-as com.example.demo cat files/config.xmlrun-as 只在应用是 debug 包时可用的限制让它在生产版本上完全失效这也是为什么很多调试方案要求专门安装 debug 包。文件传输不只是拷数据也是绕过 UI 直接改配置的快捷通道掌握 push 和 pull 能省掉大量手工操作。4. fastboot 刷机链路bootloader 分区表和 A/B 槽位一次讲清4.1 adb 与 fastboot两条互不相通的调试通道adb 跑在系统启动之后依赖 Android 的调试服务fastboot 跑在 bootloader 阶段比系统层更底层。两者使用完全不同的驱动和协议这个认知能避免大量困惑。在系统里执行下面命令进入 bootloaderadb reboot bootloader手机关机后可以尝试音量下加电源键组合进入但不同设备组合键不一样最可靠的方式还是先保证 adb 可用然后用命令切换。进入 bootloader 后 adb devices 就失效了必须用 fastboot 枚举fastboot devices正常会显示设备序列号和 fastboot 字样部分设备显示 ????? 加 fastboot这通常是 bootloader 阶段驱动未匹配或 USB 枚举未完成的信号。fastboot 通道的驱动和 adb 驱动不是一个东西Windows 下经常出现“adb 能连fastboot 找不到设备”的情况排查思路看下一节。4.2 分区与镜像对应关系刷的时候到底在写哪里刷机之前先建立分区概念。一张完整的系统镜像会拆成多个分区镜像常见的是 boot.img、recovery.img、system.img。boot 分区存放内核和启动 ramdiskrecovery 是独立恢复系统system 是只读系统分区。刷镜像就是把这些镜像写到对应分区REM 刷入 boot 和 recovery 分区 fastboot flash boot boot.img fastboot flash recovery recovery.img REM 清除用户数据分区相当于恢复出厂设置 fastboot erase userdataerase 清除用户数据分区刷完通常要执行一次避免旧数据干扰新系统。vendor 分区存放厂商专属库文件非必要不要动bootloader 分区这类更底层分区刷错就直接变砖没有后悔药。所以刷机前先用 getvar 确认分区情况fastboot getvar current-slot fastboot getvar allgetvar 是查询 fastboot 运行环境变量的命令current-slot 返回当前激活的槽位all 列出全部变量。A/B 设备存在两个系统槽位 a 和 b分区名带后缀如 boot_a、boot_b。刷机如果不带后缀部分设备会同时写入两个槽位或直接报错。切换槽位用fastboot set_active b fastboot reboot注意getvar 查询的是 fastboot 环境变量不是系统属性以设备返回值为准。部分设备对变量名大小写敏感建议先 getvar all 看清楚再操作。切换槽位在升级验证场景里很实用把新系统刷入备用槽位从备用槽启动测试失败还能切回原槽位相当于给自己留了一条后悔路。4.3 解锁 bootloader清数据、验签拦截与老工具的能力边界刷入非官方镜像前通常需要解锁 bootloader。解锁命令因设备方案而异常见的是 fastboot flashing unlock 或 fastboot oem unlock。执行后设备会进入确认界面用音量键选择并确认。解锁的代价是强制清除所有用户数据这是安全机制没有绕过的空间。做这一步前把 /sdcard 里的照片和重要文件先 pull 出来REM 把整个共享存储拉回本地防止解锁清空数据 adb pull /sdcard/ ./backup_full/28.0.1 的 fastboot 能力覆盖到 Android 9 左右的设备没有问题但新机型引入了动态分区和新的刷机模式老版本 fastboot 对某些命令会报 unknown command。判断原则很简单先查分区存在性再刷别拿老工具硬怼新分区方案。5. platform-tools 28.0.1 避坑指南5 个典型故障的现象、原因与排查5.1 设备显示 offline过一会儿又变 device现象adb devices 里序列号后面是 offline不拔线的情况下状态反复横跳。原因最常见的是 adb server 残留着旧版本服务Windows 下多开几个开发工具时尤其严重其次是 USB 口供电不稳老台式机前置 USB 口特别容易触发。解决先重启 adb 服务再观察。REM 杀掉旧 adb server 进程并重新启动 adb kill-server adb start-server adb devices这一步能解决大部分 server 层面的问题。如果还是 offline换线换口测试优先用 USB 2.0 后置口。还不行就在设备管理器里卸载该设备驱动重新插拔让系统重装驱动。5.2 驱动装了adb 还是找不到设备现象设备管理器里没有问号但 adb devices 列表为空。原因手机 USB 模式停在“仅充电”调试服务没有暴露给电脑或者 OEM 驱动与当前系统版本不匹配。解决先在手机的 USB 配置里切换到“文件传输”模式不同系统叫法不同可能是 MTP 或“传输文件”然后拔插一次数据线。驱动层面确认设备管理器里出现的是 ADB Interface 而不是“便携设备”后者说明走的还是 MTP 协议adb 依然不可用。老设备在较新系统上装不上驱动时只能走禁用驱动程序强制签名的方式临时安装装完记得把强制签名恢复否则后续装其他驱动会遇到一堆莫名其妙的问题。5.3 fastboot 报 unknown partition 或 not found现象执行 fastboot flash system system.img返回 unknown partition。原因设备分区名和默认印象不一致。A/B 设备实际分区名是 system_a 或 system_b动态分区设备把 system、vendor 等合并进 super 分区老工具链不识别这套新结构。解决先查询分区再决定怎么刷REM 查询指定分区是否存在 fastboot getvar partition-type:system_a fastboot getvar partition-type:superpartition-type: 前缀用于查询指定分区的类型返回有效值说明该分区存在。对 A/B 设备分区名后面补上 _a对动态分区设备28.0.1 的 fastboot 已经力不从心直接换新版 platform-tools或按设备方案进入对应的刷机模式。5.4 覆盖安装报 INSTALL_FAILED_UPDATE_INCOMPATIBLE现象adb install -r 安装新版 APK直接报签名冲突。原因新旧 APK 签名不一致系统拒绝用新签名覆盖旧签名的应用。常见于同一台测试机上 debug 包和 release 包混装。解决签名不一致只能先卸载REM 卸载旧应用数据会一并清除 adb uninstall com.example.demo adb install app-release.apk卸载必然丢失应用数据这个操作不可逆。预防办法是给测试机固定使用同一套签名debug 包和 release 包分开设备验证别挤在同一台机器上。5.5 刷机过程全成功但开机卡在品牌 logo现象fastboot 刷入全部镜像后重启长时间停留在开机界面。原因刷入的 boot 镜像与系统版本不匹配或者只刷了 boot 没刷对应 system内核与系统版本不一致导致无法启动。解决先刷回官方完整镜像的 boot 和 system确认能正常开机再考虑其他方案REM 刷回官方 boot 和 system 分区 fastboot flash boot boot.img fastboot flash system system.imgsystem.img 如果是稀疏镜像部分老版本 fastboot 写入会异常优先使用官方提供的非稀疏镜像。开不了机时别急着说变砖只要 bootloader 和 recovery 还在就能反复重刷真正危险的是手滑刷错 bootloader 分区。6. 让 28.0.1 继续够用无线调试、多设备分流与老工具的边界6.1 无线调试摆脱数据线的三条命令手机连上同一局域网后先用 USB 开启无线调试端口REM 开启无线调试端口 adb tcpip 5555 adb connect 192.168.1.100:5555tcpip 5555 让设备在 5555 端口监听 adb 连接connect 后面跟设备在局域网里的 IP。执行成功后 adb devices 里会出现 IP 加端口号的条目USB 线就可以拔了。注意一点电脑端 adb server 重启后无线连接不会自动恢复重新 connect 一次就行不用重新插线。6.2 多设备分流与版本锁定两个值得固化的习惯同时挂着多台设备时命令会提示设备不唯一这时用 -s 指定设备序列号adb -s 设备序列号 shell脚本里先执行 adb devices 拿全部序列号再对每个序列号执行 -s 操作就能批量跑。同型号多台设备只靠序列号容易认错建议在开发者选项里把设备名改成任务代号拉日志时用设备名做文件名前缀。最后说版本锁定的习惯。常有开发者把 28.0.1 和系统里另一个 adb 混着用折腾半宿才发现是两套版本输出格式不一样。我的习惯是每个项目在文档里写明所用 platform-tools 的确切版本脚本开头加一个版本断言维护老旧设备时就固定用 28.0.1遇到新设备新分区方案果断换新版不让情怀耽误进度。这个习惯帮我避开了不少低级返工希望帮到你。本文还有配套的精品资源点击获取
