Przewodnik krok po kroku ułatwiający rozpoczęcie pracy z narzędziem Android Debug Bridge.
Szybkie linki
- Co to jest mostek debugowania Androida (ADB)?
- Jak działa ADB?
- Jak skonfigurować ADB
- Przykłady poleceń ADB
- Co jeszcze mogę zrobić z ADB?
Dostęp do kilku funkcji systemu operacyjnego Android można uzyskać jedynie za pomocą ścieżek i metod ukrytych przed przeciętnym użytkownikiem. Zwykle robiono to za pomocą niektórych poleceń Android Debug Bridge (ADB) wiersza poleceń, narzędzia oferowanego przez Google dla programistów do debugowania różnych części ich aplikacji lub systemu, ale których możemy używać do wszelkiego rodzaju schludnych i ukrytych wydziwianie. Warunkiem stosowania tych sztuczek jest zainstalowanie ADB na komputerze. Dlatego w tym przewodniku pokażemy, jak zainstalować ADB w systemach Windows, macOS i Linux, wykonując szybkie i łatwe do wykonania kroki.
Co to jest mostek debugowania Androida (ADB)?
Wewnętrzna struktura Android Debug Bridge (ADB) opiera się na klasycznej architekturze klient-serwer. Na cały proces składają się trzy elementy.
- Klient, czyli komputer PC/Mac/Chromebook, z którym łączysz się ze swoim urządzeniem z systemem Android. Polecenia do naszego urządzenia wysyłamy z komputera poprzez kabel USB lub bezprzewodowo.
- Demon (znany jako „adbd”) uruchamiający polecenia na urządzeniu. Demon działa jako proces w tle na każdym urządzeniu.
- Serwer zarządzający komunikacją pomiędzy klientem a demonem. Serwer działa na komputerze jako proces w tle.
Jak działa ADB?
Ponieważ ADB składa się z trzech elementów (klient, demon i serwer), wymaga to przede wszystkim, aby pewne elementy działały. Jeśli komputer został świeżo uruchomiony (i nie masz go skonfigurowanego do uruchamiania demona podczas rozruchu), wtedy będziesz musiał go uruchomić, zanim jakakolwiek komunikacja będzie mogła zostać wysłana do docelowego systemu Android urządzenie. W wierszu poleceń lub terminalu zobaczysz następujący komunikat, który sprawdzi, czy demon działa.
Jeśli demon nie jest uruchomiony, rozpocznie proces i poinformuje Cię, na którym lokalnym porcie TCP został uruchomiony. Po uruchomieniu usługi ADB będzie ona nadal nasłuchiwać na tym konkretnym porcie poleceń wysłanych przez klienta ADB. Następnie skonfiguruje połączenia ze wszystkimi działającymi urządzeniami podłączonymi do komputera (w tym emulatorami). To moment, w którym otrzymasz prośbę o autoryzację na urządzeniu z Androidem, jeśli komputer nie był wcześniej autoryzowany.
Jak skonfigurować ADB
Uwaga: konfiguracja ADB na komputerze to tylko połowa równania, ponieważ aby zaakceptować polecenia ADB, musisz także wykonać pewne czynności na smartfonie lub tablecie.
Ustawienia telefonu
- Uruchom Ustawienia aplikację na swoim telefonie.
- Stuknij w O telefonie opcja zazwyczaj znajdująca się na dole listy.
- W zależności od skóry OEM, O telefonie strona może nazywać się inaczej lub być ukryta w innym miejscu Ustawienia aplikację na swoim urządzeniu.
- Następnie dotknij Numer kompilacji opcję siedem razy, aby włączyć tryb programisty. Po zakończeniu zobaczysz komunikat toastowy.
- Teraz wróć do głównego ekranu Ustawień i powinieneś zobaczyć nowy Opcje programistyczne menu, do którego masz dostęp. Na telefonach Google Pixel i niektórych innych urządzeniach może być konieczna nawigacja do Ustawienia > System znaleźć Opcje programistyczne menu.
- Wejdź tam i włącz debugowanie USB opcja.
- Proces konfiguracji telefonu został częściowo zakończony. Następnie przewiń poniżej i postępuj zgodnie z pozostałymi instrukcjami dla konkretnego systemu operacyjnego.
Jak skonfigurować ADB w systemie Microsoft Windows
- Pobierz Plik ZIP narzędzi platformy Android SDK dla systemu Windows.
- Wyodrębnij zawartość tego pliku ZIP do łatwo dostępnego folderu (takiego jak C:\platform-tools).
- otwarty Przeglądarka plików i przejdź do miejsca, w którym rozpakowałeś zawartość tego pliku ZIP.
- Otwórz instancję wiersza poleceń/terminalu z tego samego katalogu, w którym znajduje się ten plik binarny ADB. Można to zrobić, przytrzymując Shift i klikając prawym przyciskiem myszy w folderze, a następnie klikając Otwórz tutaj okno poleceń Lub Otwórz tutaj okno PowerShell. Użytkownicy systemu Windows 11 powinni zobaczyć Otwórz w terminalu w menu kontekstowym prawym przyciskiem myszy, nawet bez naciskania przycisku Shift na klawiaturze.
- Podłącz smartfon lub tablet do komputera za pomocą kabla USB. Zmień tryb USB na tryb „transferu plików (MTP)”. Niektórzy producenci OEM mogą tego wymagać lub nie, ale najlepiej po prostu pozostawić go w tym trybie dla ogólnej zgodności.
- W oknie Wiersz poleceń/Terminal wprowadź następujące polecenie, aby uruchomić demona ADB:
adb devices
- Na ekranie telefonu powinien pojawić się monit o zezwolenie lub odmowę dostępu do debugowania USB. Oczywiście po wyświetleniu monitu będziesz chciał przyznać dostęp do debugowania USB (i dotknij pola wyboru zawsze zezwalaj, jeśli nie chcesz nigdy więcej widzieć tego monitu).
- Na koniec wprowadź ponownie polecenie z kroku 6. Jeśli wszystko się powiedzie, powinieneś teraz zobaczyć numer seryjny swojego urządzenia w wierszu poleceń (lub oknie PowerShell).
Możesz teraz uruchomić dowolne polecenie ADB na swoim urządzeniu! Teraz idź i rozpocznij modowanie swojego telefonu, postępując zgodnie z naszą obszerną listą samouczków!
Jak skonfigurować ADB na macOS
- Pobierz Plik ZIP narzędzi platformy Android SDK dla systemu macOS.
- Wyodrębnij plik ZIP do łatwo dostępnej lokalizacji (na przykład na Pulpicie).
- Otwórz Terminal.
- Aby przejść do folderu, do którego wyodrębniono ADB, wprowadź następujące polecenie:
cd /path/to/extracted/folder/
- Na przykład możesz umieścić zawartość na pulpicie:
cd /Users/XDA/Desktop/platform-tools/
- Na przykład możesz umieścić zawartość na pulpicie:
- Podłącz urządzenie do komputera Mac za pomocą kompatybilnego kabla USB. Zmień tryb połączenia USB na tryb „transferu plików (MTP)”. Nie zawsze jest to wymagane w przypadku każdego urządzenia, ale najlepiej po prostu pozostawić je w tym trybie, aby nie napotkać żadnych problemów.
- Gdy terminal znajdzie się w tym samym folderze, w którym znajdują się narzędzia ADB, możesz wykonać następujące polecenie, aby uruchomić demona ADB:
./adb devices
- Na swoim urządzeniu zobaczysz Pozwól na debugowanie USB podpowiedź. Zezwól na połączenie.
- Na koniec wprowadź ponownie polecenie z kroku 7. Jeśli wszystko się powiedzie, powinieneś teraz zobaczyć numer seryjny swojego urządzenia w oknie terminala systemu macOS.
Gratulacje! Możesz teraz uruchomić dowolne polecenie ADB na swoim urządzeniu! Teraz idź i zacznij modyfikować swój telefon.
Chociaż powyższy przewodnik z pewnością zadziała, doświadczeni użytkownicy systemu macOS mogą również zdecydować się na zainstalowanie ADB na swoich komputerach Mac za pomocą nieoficjalnego menedżera pakietów, takiego jak Domowe piwo Lub MacPorty. Dzięki temu nie będziesz musiał ręcznie aktualizować plików binarnych.
Jak skonfigurować ADB w systemie Linux
- Pobierz Plik ZIP narzędzi platformy Android SDK dla systemu Linux.
- Wyodrębnij plik ZIP do łatwo dostępnej lokalizacji (na przykład na Pulpicie).
- Otwórz okno terminala.
- Wprowadź następujące polecenie:
cd /path/to/extracted/folder/
- Spowoduje to zmianę katalogu, w którym wyodrębniono pliki ADB.
- Przykład:
cd /home/XDA/Desktop/platform-tools/
- Przykład:
- Podłącz swoje urządzenie do komputera z systemem Linux za pomocą kabla USB. Zmień tryb połączenia na tryb „transferu plików (MTP)”. Nie zawsze jest to konieczne w przypadku każdego urządzenia, ale jest zalecane, aby uniknąć żadnych problemów.
- Gdy terminal znajdzie się w tym samym folderze, w którym znajdują się narzędzia ADB, możesz wykonać następujące polecenie, aby uruchomić demona ADB:
./adb devices
- Po powrocie do smartfona lub tabletu pojawi się monit z prośbą o zezwolenie na debugowanie USB. Śmiało, przyznaj to.
- Na koniec wprowadź ponownie polecenie z kroku 8. Jeśli wszystko się udało, powinieneś teraz zobaczyć numer seryjny swojego urządzenia w wynikach okna terminala.
Gratulacje! Możesz teraz uruchomić dowolne polecenie ADB na swoim urządzeniu!
Użytkownicy Linuksa powinni wiedzieć, że istnieje łatwiejszy sposób zainstalowania ADB na swoich komputerach. Powyższy przewodnik z pewnością będzie dla Ciebie odpowiedni, ale ci, którzy posiadają główny nurt Debiana/Ubuntu lub Dystrybucja Linuksa oparta na Fedorze/SUSE może pominąć kroki 1 i 2 powyższego przewodnika i skorzystać z jednego z następujące polecenia:
- Użytkownicy systemu Linux opartego na Debianie/Ubuntu mogą wpisać następujące polecenie, aby zainstalować ADB:
sudo apt-get install android-sdk-platform-tools
- Użytkownicy systemu Linux opartego na Fedorze/SUSE mogą wpisać następujące polecenie, aby zainstalować ADB:
sudo dnf install android-tools
Jednak zawsze lepiej jest wybrać najnowszy plik binarny z wersji Android SDK Platform Tools, ponieważ pakiety specyficzne dla dystrybucji często zawierają przestarzałe kompilacje.
Przypadek specjalny: jak skonfigurować ADB w podsystemie Windows dla systemu Linux i ChromeOS
Podsystem Windows dla systemu Linux (WSL) oferuje użytkownikom systemu Windows płynny sposób uruchamiania aplikacji dla systemu Linux. Jednakże środowisko nie zapewnia jeszcze pełnego dostępu sprzętowego USB. W rezultacie ADB w ramach WSL nie może uzyskać dostępu do Twojego urządzenia z Androidem, nawet jeśli zainstalujesz je w wyżej wymieniony sposób. Niemniej jednak istnieje oficjalne obejście, które wykorzystuje oprogramowanie typu open source usbipd-win projekt. Aby dowiedzieć się więcej, zapoznaj się z naszym tutorialem na temat jak skonfigurować przekazywanie USB w WSL.
W przypadku ChromeOS musisz to zrobić włącz wbudowane środowisko programistyczne Linux Pierwszy. Domyślnie oferuje instancję Debiana. Następnie możesz łatwo skonfigurować ADB, wykonując kroki wymienione powyżej.
Aby uwzględnić tutaj wszystkie nasze bazy, użytkownicy mogą potrzebować umieścić plik ./ przed poleceniami ADB, które wymienimy w przyszłych samouczkach, szczególnie gdy używają one wyodrębnionych plików binarnych bezpośrednio z dostarczonego przez Google pakietu ZIP narzędzi platformy. Jest to coś, co prawdopodobnie będzie wiedział każdy użytkownik *nix (lub użytkownik systemu Windows korzystający z programu PowerShell/Terminal), ale znowu chcemy, aby aby jak najwięcej osób zrozumiało, jak wprowadzić te poprawki w systemie Android, niezależnie od tego, w jakim stopniu korzystasz z systemu operacyjnego wiedzieć.
Opcjonalnie: Jak skonfigurować ADB w przeglądarce
W tym celu protokół ADB można zaimplementować za pomocą interfejsu WebUSB API steruj telefonami z systemem Android bezpośrednio z przeglądarek internetowych. Jeszcze inny WebADB, czyli tak-webadb, to jeden z takich projektów, który pozwala użytkownikom korzystać z większości funkcji dostarczanych przez ADB bezpośrednio z przeglądarki internetowej, bez instalowania jakichkolwiek plików binarnych lub sterowników. Wszystko, czego potrzebujesz, to przeglądarka internetowa obsługująca interfejs API WebUSB (taka jak Google Chrome, Microsoft Edge lub Firefox) i gotowe.
Opcjonalnie: Jak korzystać z ADB przez Wi-Fi
Android 11 i nowsze wersje natywnie obsługują połączenie ADB przez Wi-Fi. Eliminuje to potrzebę zajmowania się typowymi problemami z połączeniem USB i dodatkowymi krokami, takimi jak Instalacja sterownika OEM Androida w systemie Windows.
Aby skonfigurować debugowanie bezprzewodowe, wykonaj następujące czynności:
- Upewnij się, że komputer PC/Mac i telefon są podłączone do tej samej sieci bezprzewodowej.
- Na telefonie przejdź do Opcje programistyczne pod Ustawienia i włącz Debugowanie bezprzewodowe. Na Zezwolić na debugowanie bezprzewodowe w tej sieci? wyskakujące okienko, wybierz Umożliwić.
- Stuknij w Debugowanie bezprzewodowe opcję i wybierz Sparuj urządzenie za pomocą kodu parującego.
- Zanotuj kod parowania, adres IP i numer portu wyświetlane na ekranie telefonu.
- Na komputerze PC/Mac uruchom następujące polecenie:
Użyj adresu IP i numeru portu z kroku 4.adbpairIP_Address:Port
- Po wyświetleniu monitu wprowadź kod parowania otrzymany w kroku 4. Komunikat powinien wskazywać, że Twoje urządzenie zostało pomyślnie sparowane.
- Następnie uruchom następujące polecenie w oknie terminala komputera PC/Mac:
Spójrz na Adres IP i port sekcja pod Debugowanie bezprzewodowe w kroku 3 dla adresu IP i portu.adbconnectIP_Address:Port
- Jeśli wszystko pójdzie dobrze, powinieneś zobaczyć komunikat podobny do poniższego:
connectedto 192.168.68.100:37173
- Teraz możesz wpisać dowolne polecenie powłoki ADB.
Przykłady poleceń ADB
Aby sprawdzić, czy pomyślnie zainstalowałeś ADB, podłącz urządzenie do komputera PC/Mac za pomocą kabla USB i uruchom adb devices
polecenie zgodnie z opisem powyżej. Powinno wyświetlić Twoje urządzenie wymienione w oknie Wiersz Poleceń/PowerShell/Terminal. Jeśli otrzymasz inny wynik, zalecamy rozpoczęcie od nowa.
Jak wspomniano powyżej, możesz używać ADB do robienia różnych rzeczy na urządzeniu z Androidem. Niektóre z tych poleceń są wbudowane bezpośrednio w plik binarny ADB i powinny działać na wszystkich urządzeniach. Możesz także otworzyć tak zwaną powłokę ADB, która umożliwi uruchamianie poleceń bezpośrednio na urządzeniu. Polecenia uruchamiane bezpośrednio na urządzeniu mogą się różnić w zależności od urządzenia (ponieważ producenci OEM mogą usunąć dostęp do niektórych, a także modyfikowanie zachowania ADB) i może się różnić w zależności od wersji Androida, np Dobrze.
Poniżej znajdziesz listę przykładowych poleceń, które możesz wykonać na swoim urządzeniu:
- Wydrukuj listę podłączonych urządzeń:
adb devices
- Zabij serwer ADB:
adb kill-server
- Zainstaluj aplikację:
adb install
- Skonfiguruj przekierowanie portów:
adb forward tcp: 6100 tcp: 7100
- Skopiuj plik/katalog z urządzenia:
adb pull
- Skopiuj plik/katalog na urządzenie:
adb push
- Zainicjuj powłokę ADB:
adb shell
Premia
Jeśli chcesz pójść o krok dalej, możesz skorzystać z nowego samouczka, który przeprowadzi Cię przez cały proces jak skonfigurować ADB, aby móc używać polecenia z dowolnego katalogu na pulpicie systemu Windows lub Linux.
Co jeszcze mogę zrobić z ADB?
Poniżej znajduje się lista samouczków XDA dla różnych urządzeń, które szczegółowo opisują wiele zastosowań poleceń ADB w celu modyfikowania ukrytych ustawień, dostosowywania funkcji OEM lub interfejsów użytkownika i wiele więcej!
- Jak uruchomić komputer w trybie odzyskiwania za pomocą kombinacji przycisków, ADB i aplikacji root
- Jak odinstalować oprogramowanie typu bloatware operatora/OEM bez dostępu do konta root
- Jak opróżnić telefon (i nie tylko) bez podłączania do komputera
- Jak sideloadować aplikacje na Android TV: Metody instalacji APK i ADB Sideload wyjaśnione w łatwych do wykonania krokach!
- Przywróć kafelki Szybkich ustawień Wi-Fi i danych mobilnych w systemie Android 12 i nowszych wersjach
- Kontroluj swój smartfon z Androidem z komputera za darmo za pomocą scrcpy
- Jak sparować zegarki Android Wear z nowymi telefonami bez przywracania ustawień fabrycznych
To tylko wierzchołek góry lodowej. Nie zapomnij sprawdzić nasze polecenia ADB dla każdego samouczka dla zaawansowanych użytkowników aby poznać więcej przydatnych wskazówek i wskazówek dotyczących korzystania z ADB!