SDK Platform Tools 版本資訊

Android SDK Platform-Tools 是 Android SDK 的元件，當中包含可搭配 Android 平台的工具，主要包括 adb 和 fastboot。雖然 Android 應用程式開發作業必須採用 adb，不過應用程式開發人員通常只會使用 Android Studio 所安裝的副本。如果您要直接透過指令列使用 adb，但並未安裝 Android Studio，這個下載內容就非常實用。不過，由於 Android Studio 會自動更新，如果您已安裝 Android Studio，建議您僅使用這個開發環境所安裝的副本。如要解鎖裝置的系統啟動載入程式，並以新的系統映像檔刷新，請務必使用 fastboot。這個套件過去包含 systrace，但目前已由 Studio 分析器、gpuinspector.dev 或 Perfetto 取代。

雖然 adb 和 fastboot 的某些新功能僅在近期的 Android 版本推出，不過這些功能可回溯相容，因此您只要安裝最新版本的 SDK Platform-Tools 即可。如果發現任何例外狀況，請回報錯誤。

下載內容

如果您是 Android 開發人員，請務必透過 Android Studio 的 SDK Manager 或 sdkmanager 指令列工具取得最新的 SDK Platform-Tools。這可以確保這些工具與其他 Android SDK 工具一起儲存在適當的位置，而且可以輕鬆更新。

不過，如果您只是想使用這些指令列工具，請透過以下連結下載：

• 下載 Windows 版 SDK Platform-Tools
• 下載 Mac 版 SDK Platform-Tools
• 下載 Linux 版 SDK Platform-Tools

雖然這些連結不會改變，但一律都會指向最新版本的工具。

修訂版本

34.0.0 RC2 (2023 年 3 月)

• 配合 Android 14 開發人員預覽版 2 的發布版本更新。

34.0.1 (2023 年 3 月)

• ADB
  • macOS：ADB 安裝時發生擱置問題 (問題 #270205252)，因此我們已重新採用「解決連線不穩問題 (MacBook 高速傳輸線)」解決方案。
• Fastboot
  • Windows：修正 Platform Tools 34.0.0 版中的「mke2fs：嘗試判定檔案系統大小時，發現裝置名稱無效或格式有誤」錯誤 (問題 #271039230)。

34.0.0 (2023 年 2 月)

• ADB
  • 修正 macOS 的零長度封包傳送問題 (問題追蹤編號：208675141)。
  • 解決連線不穩問題 (MacBook 高速傳輸線)：ADB 經常中斷連線。
  • 現在當 ADB 推送內的引數數量不足時，系統會顯示更完善的錯誤訊息。
• Fastboot
  • 改善刷新效果：flashall 現在會盡可能略過重新啟動至使用者空間的程序。
  • 修正 macOS 的零長度封包傳送問題 (問題追蹤編號：208675141)。
  • 修正刷新 recovery.img 導致的 AVB 頁尾錯誤。

33.0.3 (2022 年 8 月)

• ADB
  • 如果首次嘗試執行 adb root 失敗，請勿重試。
  • 修正追蹤裝置的項目重複問題。
  • 新增接收視窗 (增加高延遲連線的處理量)。
  • 針對因「more than one device」而導致失敗的情形提供更具體的錯誤訊息。
  • 拒絕非預期的反向轉送要求。
  • 修正在 Windows 上安裝多個套件的問題。
• Fastboot
  • 移除 SDK Platform-Tools 中的 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 分析器/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
  • 預設提取時停用壓縮功能。

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 以前版本裝置上已簽署 APK (v4 簽署配置) 的安裝作業。
  • 修正在未使用 ADB_VENDOR_KEYS 的情況下進行驗證時發生的當機問題。
  • 修正使用 adb -H 時發生的當機問題。

30.0.2 (2020 年 6 月)

• ADB
  • 改善 ADB 無線配對連線。
  • 修正在裝置連線前執行會導致 adb logcat 停止運作的問題。
  • 新增 adb transport-id，讓指令碼在取得 Root 權限/移除 Root 權限/重新啟動後安全地等待裝置中斷連線。

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 的推送/提取效能。

29.0.6 (2020 年 2 月)

• ADB
  • 在 Android 11 裝置上，adb ls 支援 64 位元大小/時間。
  • 支援 POSIX ::1 監聽。
  • 發布 WinUSB 描述元 (Android 11 所需) 的 WinUSB 裝置用戶端支援功能應不會再要求安裝 USB 驅動程式。
  • 修正在非檔案項目使用 adb install 時停止運作的問題。

29.0.5 (2019 年 10 月)

• ADB
  • 稍微改善 Linux 在同時使用多項連線方面的效能。
  • 將 --fastdeploy 選項新增至 adb install，適用於開發階段的 APK 漸進式更新。

29.0.4 (2019 年 9 月)

• ADB
  • LLDB 原生偵錯逾時的熱修復 (請見問題 #134613180)。這也修正了 Android Studio 分析器中導致 idea.log 檔案中出現 AdbCommandRejectedException 的相關錯誤。

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 當機問題的 Hotfix (https://issuetracker.google.com/134613180)

29.0.0 (2019 年 6 月)

• ADB
  • adb reconnect 會在 Linux 上執行 USB 重設。
  • 在 Linux 上連線至較新的 ADB 伺服器時，ADB 會嘗試公開啟動新版本，而不是終止伺服器並啟動舊版本。
  • adb root 會在中斷連線後等待裝置重新連線。先前，如果在 ADB 發現裝置已中斷連線前就開始執行 adb wait-for-device，可能會立即錯誤地傳回 adb root; adb wait-for-device。
• Fastboot
  • 先前 Fastboot 嘗試開啟 macOS 的觸控列或鍵盤時，系統會顯示錯誤訊息；現已停用這則錯誤訊息。

28.0.2 (2019 年 3 月)

• ADB
  • 先前 adb shell 通訊埠轉送的不穩定性，導致出現「Connection reset by peer」錯誤訊息；現已修正這項問題。
  • 修正裝置重新連線後透過 ADB_VENDOR_KEYS 進行驗證的問題。
  • 修正驗證問題 (用於驗證的私密金鑰與公開金鑰不符)：依私密金鑰計算公開金鑰，而非假設金鑰相符。
• Fastboot
  • 新增動態分區支援功能。
• 更新 Windows 需求條件
  • 平台工具現在依附於 Windows 通用 C 執行階段 (通常預設透過 Windows Update 安裝)。如果您看到提及缺少 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 的輸出內容。
  • 增加通訊端插座監聽工作 backlog，以允許更多同時發生的 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 月)

• 重新修正 macOS 10.13 Fastboot 錯誤；該錯誤在 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 裝置。

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 以外的實作仍維持預設設定。

• 2016 MacBook Pro 上的 Fastboot 不再出現停止運作問題 (bug 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 的相關問題