Android SDK 平台工具版本说明

Android SDK Platform-Tools 是 Android SDK 的一个组件。它包含与 Android 平台进行交互的工具，主要是 adb 和 fastboot。虽然 adb 是 Android 应用开发所必需的，但应用开发者通常仅使用 Studio 安装的副本。如果您想直接从命令行使用 adb 并且未安装 Studio，此项下载非常有用。（如果您安装了 Studio，建议您仅使用 Studio 安装的副本，因为 Studio 会自动对其进行更新。）如果您想要解锁设备的引导加载程序并为其刷入新的系统映像，则需要 fastboot。该软件包曾经包含 systrace，但已由 Studio 性能分析器、gpuinspector.dev 或 Perfetto 取代。

下载内容

如果您是 Android 开发者，则应从 Android Studio 的 SDK 管理器或 sdkmanager 命令行工具获取最新的 SDK Platform-Tools。这样可确保这些工具能够与其他 Android SDK 工具一起保存到正确的位置，并可轻松地进行更新。

但是，如果您只想使用这些命令行工具，请访问以下链接：

• 下载适用于 Windows 的 SDK Platform-Tools
• 下载适用于 Mac 的 SDK Platform-Tools
• 下载适用于 Linux 的 SDK Platform-Tools

虽然这些链接不会发生变化，但它们始终指向最新版本的工具。

修订版本

35.0.2（2024 年 7 月）

• adb
  • 修复了导致 openscreen mDNS 后端 bug 在截断查询时关闭服务器的问题（问题 294120933）。
  • 使开放式屏幕 mDNS 后端在 macOS 上正常运行。
  • 在所有平台上将 openscreen mDNS 后端设为默认。
  • 支持检测 USB SuperSpeed+（当前速度和商定速度）以进行诊断。
  • 正常关闭：在关闭时释放所有 USB 接口（所有操作系统）。

35.0.1（2024 年 3 月）

• adb
  • 改用 libusb 1.0.27

35.0.0（2024 年 2 月）

• adb
  • 在 Linux 上将 libusb 作为默认库 问题 270205252。
  • 修复了无 USB 主机上的 adb 启动问题。
  • 修复了由 USB 设备错误报告长度为零的描述符导致的 adb 挂起问题（问题 302212871）。
  • 修复了设备断开连接时 adb shell 的返回代码问题 #321787891。
• fastboot
  • 限制传入数据包队列的大小上限。
  • 移除了之前将下载速度限制在 120MB/s 左右的瓶颈。现在，fastboot 可以使 SuperSpeed+ 总线饱和，并实现最高 980MB/s 的速度，具体取决于设备。

34.0.5（2023 年 10 月）

• adb
  • 在 macOS 上，adb 现在默认为 libusb，以解决问题 270205252。
  • 以前，当无线配对失败时，adb 会返回成功代码。通过返回失败代码 (1) 和面向用户的错误 (error: protocol fault (couldn't read status message...)) 解决了这个问题。echo $? 现在报告 1。
  • adb wait-for-disconnect 现在适用于非 USB（无线调试）。
  • 添加了新的 DbC 接口，以便日后通过 adb 支持 ChromeOS。
• fastboot
  • 修复了 Pixel 3 设备上的 flashall 问题。

34.0.4（2023 年 7 月）

• adb
  • 在 adb 分叉 adb 主机服务器时传播 -a (gListenAll)（之前，此标志仅适用于 adb -a server nodaemon）
  • 更快地获取和取消获取 root 权限
  • 重新启用 Flag(env) guarding clear endpoint (device) feature for OSX usb start.（问题 270205252）。
• fastboot
  • Mac：移除了对无效 IO 迭代器的重试（使用 LIBUSB_TRANSFER_CANCELLED 进行刷写失败）
  • Windows：修复了使用“flashall”时出现的“稀疏文件过大或无效”问题
  • 所有平台：修复了使用“update”时出现的“ANDROID_PRODUCT_OUT 未设置”问题

34.0.1（2023 年 3 月）

• adb
  • macOS：由于 adb install 挂起问题，恢复了“连接不稳定问题（MacBook 高速数据线）”的解决方案（问题 270205252）。
• fastboot
  • Windows：修复了平台工具 34.0.0 中引入的“尝试确定文件系统大小时出现非法或格式有误的设备名称”错误（问题 271039230）。

34.0.0 RC2（2023 年 3 月）

• 通过发布 Android 14 开发者预览版 2 进行了更新（adb 和 fastboot 没有更新）。

34.0.0（2023 年 2 月）

• adb
  • 修复了针对 macOS 的零长度数据包发送问题（问题跟踪器：208675141）。
  • 解决了连接不稳定的问题（MacBook 高速数据线）：adb 频繁断开连接。
  • 改进了参数数量不足导致的 adb push 错误消息。
• fastboot
  • 改进了刷写功能：flashall 现在会尽可能跳过重新启动到用户空间。
  • 修复了针对 macOS 的零长度数据包发送问题（问题跟踪器：208675141）。
  • 修复了刷写 recovery.img 导致 AVB 页脚错误的问题。

33.0.3（2022 年 8 月）

• adb
  • 如果第一次尝试 adb root 时失败，请勿重试。
  • 修复了 track-devices 重复条目的问题。
  • 添加了接收窗口化功能（提高高延迟连接的吞吐量）。
  • 在“多台设备”失败情况下显示更具体的错误消息。
  • 拒绝意外的反向转发请求。
  • 修复了在 Windows 上使用 install-multi-package 命令时的问题。
• fastboot
  • 从 SDK platform-tools 中移除了 e2fsdroid。
  • 输出 OemCmdHandler 成功返回的消息。

33.0.2（2022 年 5 月）

• fastboot
  • 支持 vendor_kernel_boot 分区。

33.0.1（2022 年 3 月）

• adb
  • 修复了 Windows mdns 崩溃问题。
  • 修复了旧设备上的 enabled-verity/disable-verity 问题。
  • 修复了旧设备上的“安装多个”问题
  • 改进了帮助输出内容，以包含所有受支持的压缩方法。
• systrace
  • 已移除。请改用 Studio 性能分析器/gpuinspector.dev/Perfetto。

33.0.0（2022 年 2 月）

• adb
  • 修复了 32.0.0 中引入的在没有任何参数的情况下运行时发生崩溃的问题。

32.0.0（2022 年 1 月）

• adb
  • Apple M1 设备的通用二进制文件。
  • 已知问题：此版本在不提供任何参数的情况下运行时会崩溃。

31.0.3（2021 年 8 月）

• fastboot
  • 支持刷写 vbmeta_vendor.img 以进行 fastboot flashall/update。

31.0.2（2021 年 4 月）

• adb
  • 支持在 Linux 上转发到 vsock。
  • 修复了 adb track-devices 中采用无线调试功能的设备不会立即收到更新的 bug。
  • 无需单独安装 mDNS 服务即可实现对 mDNS 设备发现的初步支持。此功能目前默认处于停用状态，可以在启动 adb 服务器时将环境变量 ADB_MDNS_OPENSCREEN 设置为 1 来启用此功能。
• fastboot
  • 无法获取启动分区大小时不会失败。
  • 会从属性派生设备锁定状态，而不是解析内核命令行。

31.0.1（2021 年 3 月）

• adb
  • 减少了 TCP keepalive 间隔。
  • 提高了增量安装性能。
• fastboot
  • 添加了对压缩快照合并的支持。
  • 恢复了对旧版 A/B 的支持。

31.0.0（2021 年 2 月）

• adb
  • 默认情况下，在拉取时停用压缩功能。

30.0.5（2020 年 11 月）

• adb
  • 提升了通过高延迟连接推送许多文件时 adb push 的性能。
  • 提升了 adb push/pull 在 Windows 上的性能。
  • 修复了处理多个输入时 adb push --sync 的问题。
  • 提升了增量 APK 安装的性能。
  • 改进了针对增量 APK 安装的错误处理。

30.0.4（2020 年 7 月）

• adb
  • 修复了在搭载 Android 11 之前版本的设备上回退到非增量 APK 安装的问题。
  • 修复了 adb install-multi-package。
  • 修复了更多与 adb 无线配对相关的崩溃问题。
  • 改进了一些错误消息。
• fastboot
  • 改进了 fastboot oem 命令的控制台输出。
  • 修复了旧款设备（如 Nexus 7）上的 fastboot flashall 问题。

30.0.3（2020 年 6 月）

• adb
  • 修复了在搭载 Android 11 之前版本的设备上安装使用 v4 签名方案签名的 APK 的问题。
  • 修复了在不使用 ADB_VENDOR_KEYS 的情况下进行身份验证时发生崩溃的问题。
  • 修复了使用 adb -H 时发生崩溃的问题。

30.0.2（2020 年 6 月）

• adb
  • 改进了 adb 无线配对。
  • 修复了在连接设备前运行时 adb logcat 挂起的问题。
  • 添加了 adb transport-id，以允许脚本在运行 root/unroot/reboot 后安全地等待设备断开连接。

30.0.1（2020 年 5 月）

• adb
  • 默认会停用 adb mdns 自动连接。此设置可通过 ADB_MDNS_AUTO_CONNECT 环境变量重新启用。
  • 改进了 adb install-multi 在搭载 Android 10 或更高版本的设备上的性能。
  • 修复了在通过 TCP 连接的设备上使用 adb root/unroot 时超时的问题。
  • 更新了对无线配对的支持。

30.0.0（2020 年 4 月）

• adb
  • 添加了对无线配对的初步支持。
  • 添加了对增量 APK 安装的支持。
  • 实现了对 adb {push, pull, sync} 压缩的客户端支持（在搭载 Android 11 的设备上使用时）。
  • 提升了连接延迟时间较长时 adb push 的性能。
  • 提升了 Windows 上的 push/pull 性能。

29.0.6（2020 年 2 月）

• adb
  • 对 adb ls 提供 64 位大小/时间支持（在搭载 Android 11 的设备上使用时）。
  • 支持在 POSIX 上监听 ::1。
  • 在发布 WinUSB 描述符的 WinUSB 设备上，应该不需要再安装 U 盘，即可实现客户端支持（这对 Android 11 是必需的）。
  • 修复了在实际上并非文件的项中使用 adb install 时挂起的问题。

29.0.5（2019 年 10 月）

• adb
  • 使用许多同步连接时，在 Linux 上的性能略有提升。
  • 向 adb install 添加了 --fastdeploy 选项，可在开发过程中对 APK 进行增量更新。

29.0.4（2019 年 9 月）

• adb
  • LLDB 原生调试超时的修补程序（详见错误 #134613180）。这也修复了 Android Studio 性能剖析器中导致 AdbCommandRejectedException 的相关 bug，您可以在 idea.log 文件中看到该 bug。

29.0.3（2019 年 9 月）

• adb
  • adb forward --list 可与多台连接的设备配合使用。
  • 修复了设备在 Windows 上进入离线状态的问题。
  • 改进了 adb install 输出和帮助文本。
  • 可在不指定端口的情况下恢复 adb connect <host> 之前的行为。

29.0.2（2019 年 7 月）

• adb
  • 修复了 Windows 堆完整性崩溃问题。
• fastboot
  • 添加了对即将推出的新设备的分区布局的支持。

29.0.1（2019 年 6 月）

• adb
  • Windows 崩溃问题的修补程序 (https://issuetracker.google.com/134613180)

29.0.0（2019 年 6 月）

• adb
  • adb reconnect 会在 Linux 上执行 USB 重置。
  • 在 Linux 上，当连接到较新的 adb 服务器时，adb 会尝试以透明的方式启动新版本，而不是先终止服务器，再启动旧版本。
  • 断开连接后，adb root 会等待设备重新连接。 以前，如果 adb wait-for-device 在 adb 注意到设备已断开连接之前启动，adb root; adb wait-for-device 可能会错误地立即返回。
• fastboot
  • 停用了当 fastboot 试图在 macOS 上打开触控栏或键盘时出现的错误消息。

28.0.2（2019 年 3 月）

• adb
  • 修复了导致“对等方重置了连接”错误消息的 adb shell 端口转发不稳定问题。
  • 修复了重新连接设备时通过 ADB_VENDOR_KEYS 进行身份验证的问题。
  • 通过根据私钥计算公钥（而不是假定私钥和公钥匹配）修复了身份验证问题（当用于进行身份验证的私钥与公钥不匹配时）。
• fastboot
  • 添加了对动态分区的支持。
• 更新了 Windows 的相关要求
  • 平台工具现在依赖于 Windows 通用 C 运行时，它通常是通过 Windows Update 默认安装的。如果您看到提及缺少 DLL 的错误，那么可能需要手动获取并安装运行时软件包。

28.0.1（2018 年 9 月）

• adb
  • 添加了对重新连接 TCP 连接的支持。断开连接后，adb 会尝试重新连接最多 60 秒，如果仍不成功，才会放弃连接。
  • 修复了 Windows 上的 Unicode 控制台输出问题。（感谢外部贡献者 Spencer Low！）
  • 修复了可能发生的文件描述符 double-close 问题，此问题会导致连接在 adb connect 发生的同时关闭。
  • 修复了在与多个设备连接的情况下使用时 adb forward --list 的问题。
• fastboot
  • 将命令超时增加到了 30 秒，以更好地支持一些速度较慢的引导加载程序命令。

28.0.0（2018 年 6 月）

• adb:
  • 添加了对搭载 Android P 的设备的无校验和操作的支持，使吞吐量提高了多达 40%。
  • 按连接类型和设备序列号对 adb devices 的输出进行了排序。
  • 增加了套接字监听积压量，以允许同时执行更多 adb 命令。
  • 改进了 adb connect 的错误输出。
• fastboot：
  • 改进了输出格式，添加了详细输出模式 (-v)。
  • 清理了帮助输出。
  • 将 product.img 和 odm.img 添加到了由 fastboot flashall 刷写的分区列表。
  • 通过允许出厂映像软件包要求对特定分区的支持，避免在使用过旧版本的 fastboot 时导致新设备死机。

27.0.1（2017 年 12 月）

• adb：修复了在使用 USB 3.0 连接设备时在 MacOS 上出现的断言失败问题。
• fastboot：在 Windows 上，添加了对擦除使用 F2FS（闪存友好型文件系统）的设备的支持。

27.0.0（2017 年 12 月）

• 重新修复了 macOS 10.13 fastboot bug，此 bug 在 26.0.1 中首次修复，但在 26.0.2 中重新引入。

26.0.2（2017 年 10 月）

• 为 Pixel 2 设备添加了 fastboot 支持。

26.0.1（2017 年 9 月）

• 修复了 macOS 10.13 High Sierra 上的 fastboot 问题（bug 64292422）。

26.0.0（2017 年 6 月）

• 通过发布 Android O 最终版本 SDK（API 级别 26）进行了更新。

25.0.5（2017 年 4 月 24 日）

• 修复了 Windows 上大型更新的 adb 旁加载问题，此问题显示为“std::bad_alloc”（bug 37139736）。

• 修复了某些 Windows 防火墙存在的 adb 问题，此问题显示为“cannot open transport registration socketpair”（bug 37139725）。

• adb --version 和 fastboot --version 现在都包含安装路径。

• adb 已更改为不解析 localhost，以便解决 VPN 配置错误问题。

• adb 已更改为不再在 Linux 上重置 USB 设备，因为重置 USB 设备可能会影响其他连接的 USB 设备。

25.0.4（2017 年 3 月 16 日）

• 为 Linux 和 Mac adb 添加了实验性 libusb 支持

如需使用 libusb 后端，请先设置环境变量 ADB_LIBUSB=true，然后再启动新的 adb 服务器。新的 adb host-features 命令会告知您是否在使用 libusb。

如需使用 libusb 重启 adb 并检查它是否正常运行，请使用 adb kill-server; ADB_LIBUSB=1 adb start-server; adb host-features。输出应包含“libusb”。

在此版本中，旧版的非 libusb 实现仍然是默认实现。

• fastboot 不再挂起 2016 MacBook Pros（bug 231129）

• 修复了 Mac 上的 Systrace 命令行捕获问题

25.0.3（2016 年 12 月 16 日）

• 修复了导致 Android Things 设备无法刷写的 fastboot bug

25.0.2（2016 年 12 月 12 日）

• 通过发布 Android N MR1 稳定版 (API 25) 进行了更新

25.0.1（2016 年 11 月 22 日）

• 通过发布 Android N MR1 开发者预览版 2 (API 25) 进行了更新

25.0.0（2016 年 10 月 19 日）

• 通过发布 Android N MR1 开发者预览版 1 (API 25) 进行了更新

24.0.4（2016 年 10 月 14 日）

• 已更新并解决了 ADB 和 Mac OS Sierra 中的问题