SDK 平台工具发行说明

Android SDK 平台工具是 Android SDK 的一个组件。它包含与 Android 平台交互的工具，主要是 adb 和 fastboot。虽然 adb 是 Android 应用程序开发所必需的，但应用程序开发者通常只使用 Studio 安装的副本。如果您想直接从命令行使用 adb 并且没有安装 Studio，则此下载很有用。（如果您安装了 Studio，您可能只想使用它安装的副本，因为 Studio 会自动更新它。） fastboot 是在您想解锁设备引导加载程序并使用新系统映像对其进行刷机时所需的。此软件包以前包含 systrace，但它已被 Studio Profiler、gpuinspector.dev 或 Perfetto 取代。

虽然 adb 和 fastboot 中的一些新功能仅适用于 Android 的最新版本，但它们向后兼容，因此您只需要最新版本的 SDK 平台工具，并且如果发现异常，请提交错误。

下载

如果您是 Android 开发者，您应该从 Android Studio 的 SDK 管理器 或 sdkmanager 命令行工具获取最新版本的 SDK 平台工具。这可以确保这些工具与您其他 Android SDK 工具一起保存到正确的位置，并且可以轻松更新。

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

• 下载适用于 Windows 的 SDK 平台工具
• 下载适用于 Mac 的 SDK 平台工具
• 下载适用于 Linux 的 SDK 平台工具

尽管这些链接不会更改，但它们始终指向这些工具的最新版本。

修订版

35.0.2（2024 年 7 月）

• adb
  • 修复 openscreen mDNS 后端错误，该错误导致服务器在截断查询时崩溃 问题 #294120933。
  • 使 openscreen mDNS 后端在 macOS 上正常工作。
  • 使 openscreen mDNS 后端成为所有平台上的默认后端。
  • 支持检测 USB 超高速+（当前和协商速度）以进行诊断。
  • 优雅关机：在关机时释放所有 USB 接口（所有操作系统）。

35.0.1（2024 年 3 月）

• adb
  • 切换到 libusb 1.0.27

35.0.0（2024 年 2 月）

• adb
  • 切换到 libusb 作为 Linux 上的默认库 问题 #270205252。
  • 修复没有 USB 的主机上的 adb 启动问题。
  • 修复由 USB 设备错误报告零长度描述符引起的 adb 挂起问题 问题 #302212871。
  • 修复设备断开连接时 adb shell 的返回值 问题 #321787891。
• fastboot
  • 限制传入数据包队列的最大大小。
  • 删除以前将下载速度限制在大约 120MB/s 的瓶颈。现在，fastboot 可以饱和超高速+总线，并根据设备的不同，达到高达 980MB/s 的速度。

34.0.5（2023 年 10 月）

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

34.0.4（2023 年 7 月）

• adb
  • 在 adb 分叉 adb 主机服务器时传播 -a (gListenAll)（以前，此标志仅适用于 adb -a server nodaemon）
  • 更快的 root 和 unroot
  • 重新发布 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 安装挂起，恢复“不稳定的连接（MacBook 高速电缆）”解决方案 (问题 #270205252）。
• fastboot
  • Windows：修复了平台工具 34.0.0 中引入的“mke2fs: Illegal or malformed device name while trying to determine filesystem size”错误 (问题 #271039230)。

34.0.0 RC2 (2023 年 3 月)

• 随着 Android 14 开发者预览版 2 的发布更新（adb 和 fastboot 未更新）。

34.0.0 (2023 年 2 月)

• adb
  • 修复了 macOS 上的零长度数据包发送问题 (issuetracker: 208675141)。
  • 解决了不稳定的连接问题（MacBook 高速线缆）：频繁的 adb 断开连接。
  • 改进了 adb push 命令在参数不足时的错误消息。
• fastboot
  • 改进了刷机：flashall 现在将在可能的情况下跳过重启到用户空间的操作。
  • 修复了 macOS 上的零长度数据包发送问题 (issuetracker: 208675141)。
  • 修复了刷入 recovery.img 后导致 AVB 尾部错误的问题。

33.0.3 (2022 年 8 月)

• adb
  • 如果第一次尝试失败，不要重试 adb root。
  • 修复了 track-devices 重复条目问题。
  • 添加接收窗口（提高高延迟连接的吞吐量）。
  • 在“多个设备”失败情况下，提供更具体的错误消息。
  • 拒绝意外的逆向转发请求。
  • 修复了 Windows 上的 install-multi-package。
• fastboot
  • 从 SDK 平台工具中删除 e2fsdroid。
  • 在成功时打印 OemCmdHandler 返回消息。

33.0.2 (2022 年 5 月)

• fastboot
  • 支持 vendor_kernel_boot 分区。

33.0.1 (2022 年 3 月)

• adb
  • 修复了 Windows mdns 崩溃问题。
  • 修复了旧设备上的 enable-verity/disable-verity 问题。
  • 修复了旧设备上的“安装多个”问题。
  • 改进了帮助输出，包括所有支持的压缩方法。
• systrace
  • 已移除。请使用 Studio Profiler/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
  • 支持为 fastboot flashall / update 刷入 vbmeta_vendor.img。

31.0.2 (2021 年 4 月)

• adb
  • 支持转发到 Linux 上的 vsock。
  • 修复了 adb track-devices 中的错误，该错误会导致无线调试的设备无法立即收到更新。
  • 实现了对 mDNS 设备发现的初步支持，无需单独安装 mDNS 服务。目前默认情况下已禁用，可以通过在启动 adb 服务器时将环境变量 ADB_MDNS_OPENSCREEN 设置为 1 来启用。
• fastboot
  • 无法获取引导分区大小时，不要失败。
  • 从属性中获取设备锁定状态，而不是解析内核命令行。

31.0.1 (2021 年 3 月)

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

31.0.0 (2021 年 2 月)

• adb
  • 默认情况下禁用 pull 操作的压缩。

30.0.5 (2020 年 11 月)

• adb
  • 提高了在高延迟连接上推送多个文件时的 adb push 性能。
  • 提高了 Windows 上 adb push/pull 的性能。
  • 修复了具有多个输入的 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 环境变量重新启用。
  • 提高了 Android 10 或更高版本设备上 adb install-multi 的性能。
  • 修复了在通过 TCP 连接的设备上使用 adb root/unroot 时发生的超时问题。
  • 更新了对无线配对的支持。

30.0.0 (2020 年 4 月)

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

29.0.6 (2020 年 2 月)

• adb
  • 在与 Android 11 设备一起使用时，为 adb ls 提供 64 位大小/时间支持。
  • 支持在 POSIX 上监听 ::1。
  • 发布 WinUSB 描述符的 WinUSB 设备的客户端支持（Android 11 所需）不再需要安装 USB 驱动程序。
  • 修复了在使用 adb install 安装非文件内容时发生的挂起问题。

29.0.5 (2019 年 10 月)

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

29.0.4 (2019 年 9 月)

• adb
  • 针对使用 LLDB 进行原生调试时发生的超时问题（请参阅 问题 #134613180）的热修。这还修复了 Android Studio Profilers 中的关联错误，该错误会导致 AdbCommandRejectedException，您可以在 idea.log 文件中看到该错误。

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 更新默认安装。如果您看到提及缺少 DLL 的错误，则可能需要手动获取并安装 运行时包。

28.0.1 (2018 年 9 月)

• adb
  • 添加了对 TCP 连接重新连接的支持。断开连接后，adb 会尝试重新连接，最长持续 60 秒，然后放弃连接。
  • 修复了 Windows 上的 Unicode 控制台输出。（感谢外部贡献者 Spencer Low！）
  • 修复了可能发生的、导致在同时执行 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（Flash-Friendly File System）的设备的支持。

27.0.0 (2017 年 12 月)

• 重新修复了最初在 26.0.1 中修复但在 26.0.2 中重新引入的 macOS 10.13 fastboot 错误。

26.0.2 (2017 年 10 月)

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

26.0.1 (2017 年 9 月)

• 修复了 macOS 10.13 High Sierra 上的 fastboot 问题 (错误 64292422)。

26.0.0 (2017 年 6 月)

• 随着 Android O 最终版 SDK（API 级别 26）的发布更新。

25.0.5 (2017 年 4 月 24 日)

• 修复了 Windows 上大型更新的 adb sideload 问题，表现为“std::bad_alloc” (错误 37139736)。

• 修复了某些 Windows 防火墙上的 adb 问题，表现为“cannot open transport registration socketpair” (错误 37139725)。

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

• 更改了 adb，使其不再解析 localhost，以解决 VPN 配置错误的问题。

• 更改了 adb，使其不再重置 Linux 上的 USB 设备，这可能会影响其他连接的 USB 设备。

25.0.4 (2017 年 3 月 16 日)

• 在 Linux 和 Mac adb 中添加了实验性的 libusb 支持

要使用 libusb 后端，请在启动新的 adb 服务器之前设置环境变量 ADB_LIBUSB=true。新的 adb host-features 命令将告诉您是否正在使用 libusb。

要使用 libusb 重新启动 adb 并检查其是否正常工作，请使用 adb kill-server; ADB_LIBUSB=1 adb start-server; adb host-features。输出应包括“libusb”。

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

• fastboot 不再挂起 2016 年的 MacBook Pro (错误 231129)

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

25.0.3 (2016 年 12 月 16 日)

• 修复了导致 Android Things 设备无法刷机的 fastboot 错误

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 中的问题