Informacje o wersji narzędzi platformy SDK

Android SDK Platform-Tools to komponent pakietu Android SDK. Obejmuje narzędzia, które współpracują z platformą Android, głównie adb i fastboot. Chociaż adb jest wymagany do tworzenia aplikacji na Androida, deweloperzy aplikacji zwykle używają tylko kopii instalowanej przez Studio. Ta opcja pobierania jest przydatna, jeśli chcesz używać adb bezpośrednio z wiersza poleceń i nie masz zainstalowanego środowiska Studio. (Jeśli masz zainstalowane Studio, możesz po prostu użyć kopii, którą zainstalowało to narzędzie, ponieważ Studio będzie ją automatycznie aktualizować). fastboot jest potrzebny, jeśli chcesz odblokować program rozruchowy urządzenia i wgrać na nie nowy obraz systemu. Ten pakiet zawierał systrace, ale został wycofany na rzecz Studio Profiler, gpuinspector.dev lub Perfetto.

Chociaż niektóre nowe funkcje w adb i fastboot są dostępne tylko w najnowszych wersjach Androida, są one wstecznie kompatybilne, więc wystarczy Ci najnowsza wersja narzędzi platformy SDK. Jeśli znajdziesz wyjątki, zgłoś błąd.

Pobrane

Jeśli jesteś deweloperem aplikacji na Androida, pobierz najnowsze narzędzia platformy SDK z Menedżera SDK w Android Studio lub z narzędzia wiersza poleceń sdkmanager. Dzięki temu narzędzia zostaną zapisane we właściwym miejscu wraz z pozostałymi narzędziami pakietu Android SDK i będzie można je łatwo aktualizować.

Jeśli jednak chcesz używać tylko tych narzędzi wiersza poleceń, skorzystaj z tych linków:

• Pobierz narzędzia platformy SDK na Windowsa
• Pobierz narzędzia platformy SDK na Maca
• Pobierz narzędzia platformy SDK na Linuxa

Chociaż te linki się nie zmieniają, zawsze prowadzą do najnowszej wersji narzędzi.

Wersje

36.0.0 (kwiecień 2025 r.)

• adb
  • Przepisany backend USB libusb (używa interfejsu API synchronizacji zamiast interfejsu API asynchronicznego). Zwiększa niezawodność i eliminuje wyczerpywanie pamięci w systemie Linux.
  • Funkcja podłączania na gorąco w przypadku backendu USB libusb jest teraz obsługiwana w systemie Windows (umożliwia wykrywanie prędkości USB).
  • Ulepszona ikona server-status jest teraz wyświetlana, jeśli włączona jest usługa mdns.
  • Rozwiązaliśmy błąd w systemie macOS, który powodował, że nie były wysyłane pakiety o zerowej długości, co skutkowało zawieszeniem połączenia (b/208675141).
  • Rozwiązano problem z użyciem po zwolnieniu pamięci w backendzie libusb.

35.0.2 (lipiec 2024 r.)

• adb
  • Naprawiono błąd backendu mDNS openscreen, który powodował awarię serwera w przypadku obciętego zapytania problem nr 294120933.
  • Umożliwienie działania backendu mDNS openscreen w systemie macOS.
  • Ustaw backend mDNS openscreen jako domyślny na wszystkich platformach.
  • Obsługa wykrywania USB SuperSpeed+ (bieżące i uzgodnione prędkości) na potrzeby diagnostyki.
  • Grzeczne wyłączenie: zwolnienie wszystkich interfejsów USB podczas wyłączania (wszystkie systemy operacyjne).

35.0.1 (marzec 2024 r.)

• adb
  • Przełączanie na libusb 1.0.27

35.0.0 (luty 2024 r.)

• adb
  • Przełączanie na libusb jako domyślny na Linuksie problem nr 270205252.
  • Rozwiązaliśmy problem z uruchamianiem adb na hostach bez USB.
  • Rozwiązaliśmy problem z zawieszaniem się adb spowodowany przez urządzenia USB, które nieprawidłowo zgłaszały deskryptory o zerowej długości problem 302212871.
  • Naprawiono kod zwrotny adb shell, gdy urządzenie się rozłącza problem nr 321787891.
• fastboot
  • Ogranicz maksymalny rozmiar kolejki pakietów przychodzących.
  • usuwać wąskie gardła, które wcześniej ograniczały szybkość pobierania do około 120 MB/s. Obecnie fastboot może w pełni wykorzystywać magistralę SuperSpeed+ i osiągać szybkość do 980 MB/s w zależności od urządzenia.

34.0.5 (październik 2023 r.)

• adb
  • W systemie macOS adb domyślnie używa teraz biblioteki libusb, aby rozwiązać problem 270205252.
  • Wcześniej w przypadku nieudanego parowania bezprzewodowego adb zwracał kod oznaczający powodzenie. Rozwiązaliśmy ten problem, zwracając kod błędu (1) i błąd widoczny dla użytkownika (error: protocol fault (couldn't read status message...)). Usługa echo $? zgłasza teraz 1.
  • adb wait-for-disconnect jest teraz dostępny w przypadku debugowania bezprzewodowego (nie przez USB).
  • Dodano nowy interfejs DbC, który w przyszłości będzie obsługiwać ChromeOS przez adb.
• fastboot
  • Naprawiono flashall na urządzeniach Pixel 3.

34.0.4 (lipiec 2023 r.)

• adb
  • Przekazywanie -a (gListenAll), gdy adb rozwidla serwer hosta adb (wcześniej flaga działała tylko w przypadku adb -a server nodaemon)
  • Szybsze rootowanie i przywracanie urządzenia do stanu pierwotnego
  • Ponowne wdrożenie Flag(env) guarding clear endpoint (device) feature for OSX usb start.(problem nr 270205252).
• fastboot
  • Mac: usuwanie ponownych prób w przypadku nieprawidłowego iteratora wejścia/wyjścia (miganie błędu z LIBUSB_TRANSFER_CANCELLED)
  • Windows: naprawianie błędu „Sparse file is too large or invalid” podczas korzystania z polecenia „flashall”
  • Wszystkie platformy: poprawka błędu „ANDROID_PRODUCT_OUT not set” (ANDROID_PRODUCT_OUT nie jest ustawiony) podczas korzystania z polecenia „update” (aktualizuj)

34.0.1 (marzec 2023 r.)

• adb
  • macOS: wycofano rozwiązanie problemu „niestabilne połączenie (kabel szybkiego przesyłania danych MacBooka)” z powodu zawieszania się instalacji adb (problem 270205252).
• fastboot
  • Windows: naprawiono błąd „mke2fs: Illegal or malformed device name while trying to determine filesystem size” (Nieprawidłowa lub źle sformatowana nazwa urządzenia podczas próby określenia rozmiaru systemu plików), który pojawił się w narzędziach platformy w wersji 34.0.0 (problem 271039230).

34.0.0 RC2 (marzec 2023 r.)

• Zaktualizowano po wydaniu wersji przedpremierowej Androida 14 dla programistów 2 (bez zmian w przypadku adb i fastboot).

34.0.0 (luty 2023 r.)

• adb
  • Naprawiono wysyłanie pakietów o zerowej długości w systemie macOS (issuetracker: 208675141).
  • Rozwiązano problem z niestabilnym połączeniem (szybki kabel MacBooka): częste rozłączanie adb.
  • Ulepszony komunikat o błędzie w przypadku polecenia adb push z niewystarczającą liczbą argumentów.
• fastboot
  • Ulepszone flashowanie: flashall będzie teraz pomijać ponowne uruchamianie do przestrzeni użytkownika, jeśli to możliwe.
  • Naprawiono wysyłanie pakietów o zerowej długości w systemie macOS (issuetracker: 208675141).
  • Naprawiono problem z miganiem pliku recovery.img, który powodował nieprawidłowy stopkę AVB.

33.0.3 (sierpień 2022 r.)

• adb
  • Nie ponawiaj próby adb root, jeśli pierwsza próba się nie powiodła.
  • Napraw duplikat wpisu dotyczącego śledzenia urządzeń.
  • Dodaj okno odbioru (zwiększ przepustowość połączeń o dużych opóźnieniach).
  • Bardziej szczegółowe komunikaty o błędach w przypadku niepowodzenia „więcej niż jedno urządzenie”.
  • Odrzucaj nieoczekiwane żądania dotyczące odwrotnego przekazywania.
  • Naprawiono instalację wielu pakietów w systemie Windows.
• fastboot
  • Usuń e2fsdroid z narzędzi platformy pakietu SDK.
  • W przypadku powodzenia wydrukuj komunikat zwrotny PrintOemCmdHandler.

33.0.2 (maj 2022 r.)

• fastboot
  • Obsługa partycji vendor_kernel_boot.

33.0.1 (marzec 2022 r.)

• adb
  • Rozwiązuje problemy z awariami mdns w systemie Windows.
  • Naprawia włączanie i wyłączanie weryfikacji na starszych urządzeniach.
  • Poprawki dotyczące instalowania wielu aplikacji na starszych urządzeniach
  • Ulepsza dane wyjściowe pomocy, aby uwzględniać wszystkie obsługiwane metody kompresji.
• systrace
  • Usunięto. Zamiast niego używaj narzędzi Studio Profiler, gpuinspector.dev lub Perfetto.

33.0.0 (luty 2022 r.)

• adb
  • Rozwiązuje problem wprowadzony w wersji 32.0.0, który powodował awarie podczas uruchamiania bez argumentów.

32.0.0 (styczeń 2022 r.)

• adb
  • Uniwersalny plik binarny dla urządzeń Apple M1.
  • Znany problem: ta wersja ulega awarii, gdy jest uruchamiana bez argumentów.

31.0.3 (sierpień 2021 r.)

• fastboot
  • Obsługa flashowania pliku vbmeta_vendor.img za pomocą poleceń fastboot flashall / update.

31.0.2 (kwiecień 2021 r.)

• adb
  • Obsługa przekazywania do vsock w systemie Linux.
  • Naprawiono błąd w adb track-devices, który powodował, że urządzenia z włączonym debugowaniem bezprzewodowym nie otrzymywały od razu aktualizacji.
  • Wdrożenie wstępnej obsługi wykrywania urządzeń mDNS bez oddzielnie zainstalowanej usługi mDNS. Ta funkcja jest obecnie domyślnie wyłączona. Możesz ją włączyć, ustawiając zmienną środowiskową ADB_MDNS_OPENSCREEN na 1 podczas uruchamiania serwera adb.
• fastboot
  • Nie powoduj błędu, gdy nie można uzyskać rozmiaru partycji rozruchowej.
  • Określanie stanu zablokowania urządzenia na podstawie właściwości zamiast analizowania wiersza poleceń jądra.

31.0.1 (marzec 2021 r.)

• adb
  • Zmniejsz przedział czasowy utrzymywania aktywności TCP.
  • Poprawić skuteczność instalacji przyrostowych.
• fastboot
  • Dodanie obsługi scalania skompresowanych zrzutów.
  • Przywróć starszą obsługę testów A/B.

31.0.0 (luty 2021 r.)

• adb
  • Domyślnie wyłącz kompresję podczas pobierania.

30.0.5 (listopad 2020 r.)

• adb
  • Zwiększyliśmy wydajność adb push podczas przesyłania wielu plików przez połączenie o dużym opóźnieniu.
  • Zwiększ wydajność adb push/pull w systemie Windows.
  • Naprawianie adb push --sync przy użyciu wielu danych wejściowych.
  • Poprawiliśmy wydajność instalacji przyrostowej plików APK.
  • Poprawiliśmy obsługę błędów podczas instalacji przyrostowej plików APK.

30.0.4 (lipiec 2020 r.)

• adb
  • Naprawiono powrót do nieprzyrostowej instalacji plików APK na urządzeniach z Androidem w wersji starszej niż 11.
  • Rozwiąż problem adb install-multi-package.
  • Rozwiązaliśmy kilka dodatkowych problemów powodujących awarie związanych z bezprzewodowym parowaniem adb.
  • Ulepszyliśmy niektóre komunikaty o błędach.
• fastboot
  • Ulepsz dane wyjściowe konsoli w przypadku poleceń fastboot oem.
  • Rozwiązywanie problemów z fastboot flashall na starszych urządzeniach, takich jak Nexus 7.

30.0.3 (czerwiec 2020 r.)

• adb
  • Naprawiono instalację plików APK podpisanych przy użyciu schematu podpisu w wersji 4 na urządzeniach z Androidem w wersji starszej niż 11.
  • Naprawiono błąd powodujący awarię podczas uwierzytelniania bez ADB_VENDOR_KEYS.
  • Naprawiono awarię podczas korzystania z adb -H.

30.0.2 (czerwiec 2020 r.)

• adb
  • Ulepszone parowanie bezprzewodowe adb.
  • Naprawiono zawieszanie się w adb logcat, gdy polecenie jest uruchamiane przed podłączeniem urządzenia.
  • Dodaj adb transport-id, aby umożliwić skryptom bezpieczne oczekiwanie na zniknięcie urządzenia po uzyskaniu dostępu do roota, usunięciu roota lub ponownym uruchomieniu.

30.0.1 (maj 2020 r.)

• adb
  • Domyślnie wyłącz automatyczne łączenie adb mdns. Można ją ponownie włączyć za pomocą zmiennej środowiskowej ADB_MDNS_AUTO_CONNECT.
  • Zwiększ wydajność adb install-multi na urządzeniach z Androidem 10 lub nowszym.
  • Naprawiono przekroczenie limitu czasu podczas korzystania z adb root/unroot na urządzeniu połączonym przez TCP.
  • Zaktualizowano obsługę parowania bezprzewodowego.

30.0.0 (kwiecień 2020 r.)

• adb
  • Dodano wstępną obsługę parowania bezprzewodowego.
  • Dodano obsługę przyrostowej instalacji plików APK.
  • Wdrażanie obsługi kompresji po stronie klienta w przypadku korzystania z urządzenia z Androidem 11.adb {push, pull, sync}
  • Poprawia wydajność adb push w przypadku połączeń o dużych opóźnieniach.
  • Poprawienie wydajności operacji push/pull w systemie Windows.

29.0.6 (luty 2020 r.)

• adb
  • Obsługa rozmiaru/czasu 64-bitowego w przypadku adb ls na urządzeniu z Androidem 11.
  • Obsługa nasłuchiwania na ::1 w systemie POSIX.
  • Obsługa klienta w przypadku urządzeń WinUSB, które publikują deskryptor WinUSB (wymagany w Androidzie 11), nie powinna już wymagać instalowania sterownika USB.
  • Naprawiono zawieszanie się podczas używania adb install w przypadku elementów, które nie są plikami.

29.0.5 (październik 2019 r.)

• adb
  • Nieznaczne zwiększenie wydajności w systemie Linux w przypadku korzystania z wielu jednoczesnych połączeń.
  • Dodano opcję --fastdeploy do adb install, aby umożliwić przyrostowe aktualizacje plików APK podczas tworzenia aplikacji.

29.0.4 (wrzesień 2019 r.)

• adb
  • Poprawka dotycząca limitu czasu debugowania kodu natywnego w przypadku LLDB (patrz problem 134613180). Rozwiązuje to też powiązany błąd w profilerach Android Studio, który powoduje wystąpienie AdbCommandRejectedException. Możesz go zobaczyć w pliku idea.log.

29.0.3 (wrzesień 2019 r.)

• adb
  • adb forward --list działa z wieloma podłączonymi urządzeniami.
  • Rozwiązywanie problemów z przechodzeniem urządzeń w tryb offline w systemie Windows.
  • Ulepsz adb install dane wyjściowe i tekst pomocy.
  • Przywróć poprzednie działanie adb connect <host> bez określania portu.

29.0.2 (lipiec 2019 r.)

• adb
  • Naprawia błąd integralności sterty w systemie Windows.
• fastboot
  • Dodaje obsługę układu partycji na nadchodzących urządzeniach.

29.0.1 (czerwiec 2019 r.)

• adb
  • Poprawka dotycząca awarii w systemie Windows (https://issuetracker.google.com/134613180)

29.0.0 (czerwiec 2019 r.)

• adb
  • adb reconnect wykonuje reset USB na Linuksie.
  • W systemie Linux podczas łączenia się z nowszym serwerem adb zamiast zamykać serwer i uruchamiać starszy, adb próbuje uruchomić nowszą wersję w sposób niewidoczny dla użytkownika.
  • adb root – oczekiwanie na ponowne połączenie urządzenia po odłączeniu. Wcześniej funkcja adb root; adb wait-for-device mogła błędnie zwrócić natychmiastową odpowiedź, jeśli adb wait-for-device rozpoczęła się, zanim adb zauważył, że urządzenie zostało odłączone.
• fastboot
  • Wyłącza komunikat o błędzie, który pojawiał się, gdy fastboot próbował otworzyć pasek dotykowy lub klawiaturę w systemie macOS.

28.0.2 (marzec 2019 r.)

• adb
  • Poprawiono niestabilność adb shell przekierowania portów, która powodowała wyświetlanie komunikatu o błędzie „Połączenie zresetowane przez zdalnego hosta”.
  • Rozwiązuje problem z uwierzytelnianiem za pomocą ADB_VENDOR_KEYS podczas ponownego łączenia urządzeń.
  • Rozwiązuje problem z uwierzytelnianiem, gdy klucz prywatny używany do uwierzytelniania nie pasuje do klucza publicznego. W takim przypadku oblicza klucz publiczny na podstawie klucza prywatnego, zamiast zakładać, że pasują do siebie.
• fastboot
  • Dodaje obsługę partycji dynamicznych.
• Zaktualizowane wymagania dotyczące systemu Windows
  • Narzędzia platformy zależą teraz od środowiska wykonawczego C Universal w systemie Windows, które jest zwykle instalowane domyślnie za pomocą usługi Windows Update. Jeśli pojawią się błędy dotyczące brakujących bibliotek DLL, może być konieczne ręczne pobranie i zainstalowanie pakietu środowiska wykonawczego.

28.0.1 (wrzesień 2018 r.)

• adb
  • Dodaliśmy obsługę ponownego nawiązywania połączeń TCP. Po rozłączeniu adb będzie próbować ponownie nawiązać połączenie przez maksymalnie 60 sekund, zanim zrezygnuje.
  • Poprawiono dane wyjściowe konsoli Unicode w systemie Windows. (Dziękujemy za pomoc zewnętrznemu współpracownikowi Spencerowi Low!)
  • Naprawiliśmy błąd podwójnego zamykania deskryptora pliku, który może powodować zamykanie połączeń, gdy jednocześnie występuje błąd adb connect.
  • Naprawiono adb forward --list w przypadku korzystania z więcej niż 1 podłączonego urządzenia.
• fastboot
  • Zwiększ limit czasu polecenia do 30 sekund, aby lepiej obsługiwać niektóre wolne polecenia programu ładującego.

28.0.0 (czerwiec 2018 r.)

• adb:
  • Dodano obsługę działania bez sumy kontrolnej na urządzeniach z Androidem P, co zwiększa przepustowość nawet o 40%.
  • Sortuj dane wyjściowe polecenia adb devices według typu połączenia i numeru seryjnego urządzenia.
  • Zwiększ kolejkę oczekujących gniazd, aby umożliwić wykonywanie większej liczby poleceń adb jednocześnie.
  • Ulepszyliśmy dane wyjściowe błędów dla typu ustawienia adb connect.
• fastboot:
  • Ulepsz format wyjściowy, dodaj tryb szczegółowych danych wyjściowych (-v).
  • Usuń dane wyjściowe pomocy.
  • Dodaj product.img i odm.img do listy partycji flashowanych przez fastboot flashall.
  • Zapobiegaj uszkodzeniu nowych urządzeń podczas korzystania ze zbyt starej wersji fastboot, zezwalając pakietom obrazów fabrycznych na wymaganie obsługi określonych partycji.

27.0.1 (grudzień 2017 r.)

• adb: rozwiązuje problem z błędem asercji w systemie macOS, który występował podczas łączenia urządzeń za pomocą USB 3.0.
• Fastboot: w systemie Windows dodaje obsługę czyszczenia urządzeń, które używają systemu plików F2FS (Flash-Friendly File System).

27.0.0 (grudzień 2017 r.)

• Ponownie rozwiązuje problem z trybem fastboot w systemie macOS 10.13, który został po raz pierwszy rozwiązany w wersji 26.0.1, ale ponownie pojawił się w wersji 26.0.2.

26.0.2 (październik 2017 r.)

• Dodano obsługę fastboot dla urządzeń Pixel 2.

26.0.1 (wrzesień 2017 r.)

• Rozwiązano problemy z fastbootem w systemie macOS 10.13 High Sierra (błąd 64292422).

26.0.0 (czerwiec 2017 r.)

• Zaktualizowano po udostępnieniu ostatecznej wersji pakietu SDK Androida O (interfejs API na poziomie 26).

25.0.5 (24 kwietnia 2017 r.)

• Naprawiono problem z przesyłaniem dużych aktualizacji za pomocą adb na urządzeniach z systemem Windows, który objawiał się błędem „std::bad_alloc” (błąd 37139736).

• Rozwiązaliśmy problemy z adb w przypadku niektórych zapór sieciowych systemu Windows, które objawiały się komunikatem „cannot open transport registration socketpair” (błąd 37139725).

• Zarówno adb --version, jak i fastboot --version zawierają teraz ścieżkę instalacji.

• Zmieniono adb, aby nie rozwiązywać problemu z localhost w celu obejścia nieprawidłowo skonfigurowanej sieci VPN.

• Zmieniono działanie adb, aby nie resetował już urządzeń USB w systemie Linux, co mogło mieć wpływ na inne podłączone urządzenia USB.

25.0.4 (16 marca 2017 r.)

• Dodano eksperymentalną obsługę libusb w przypadku adb na Linuksa i Maca

Aby użyć backendu libusb, przed uruchomieniem nowego serwera adb ustaw zmienną środowiskową ADB_LIBUSB=true. Nowe polecenie adb host-features poinformuje Cię, czy używasz biblioteki libusb.

Aby ponownie uruchomić adb z libusb i sprawdzić, czy działa, użyj polecenia adb kill-server; ADB_LIBUSB=1 adb start-server; adb host-features. Dane wyjściowe powinny zawierać ciąg „libusb”.

W tej wersji domyślnie nadal używane jest starsze wdrożenie bez libusb.

• fastboot nie zawiesza już MacBooków Pro z 2016 roku (błąd 231129)

• Naprawiono przechwytywanie wiersza poleceń Systrace na komputerach Mac

25.0.3 (16 grudnia 2016 r.)

• Naprawiono błąd fastboot, który powodował, że urządzenia z Androidem Things nie mogły być flashowane.

25.0.2 (12 grudnia 2016 r.)

• Zaktualizowano o stabilną wersję Androida N MR1 (API 25)

25.0.1 (22 listopada 2016 r.)

• Zaktualizowano po wprowadzeniu wersji Android N MR1 Developer Preview 2 (API 25)

25.0.0 (19 października 2016 r.)

• Zaktualizowano po wprowadzeniu wersji deweloperskiej Androida N MR1 1 (API 25)

24.0.4 (14 października 2016 r.)

• Zaktualizowano, aby rozwiązać problemy w ADB i Mac OS Sierra