Zawsze testuj aplikację na Androida na na prawdziwym urządzeniu przed udostępnieniem go użytkownikom. Na tej stronie dowiesz się, jak skonfigurować środowiska programistycznego i urządzenia z Androidem do testowania i debugowania połączenie Android Debug Bridge (ADB).
Konfigurowanie urządzenia na potrzeby programowania
Zanim zaczniesz debugować na urządzeniu, zdecyduj, czy chcesz połączyć z urządzeniem za pomocą kabla USB lub Wi-Fi. Następnie:
Na urządzeniu otwórz aplikację Ustawienia, wybierz Opcje programisty. i włącz Debugowanie USB (w razie potrzeby).
Skonfiguruj system w taki sposób, aby wykrywał urządzenie.
- ChromeOS: nie jest wymagana dodatkowa konfiguracja.
- macOS: nie jest wymagana dodatkowa konfiguracja.
- Windows: zainstaluj sterownik USB dla ADB (jeśli jest dostępny). Dla przewodnik instalacji i linki do sterowników OEM. Patrz: zainstaluj USB USB OEM kierowcy.
Ubuntu Linux: skonfiguruj te elementy:
- Każdy użytkownik, który chce używać ADB, musi należeć do grupy
plugdev
. Jeśli pojawia się komunikat o błędzie informujący, że nie jesteś w grupęplugdev
, dodaj do niej siebie za pomocą tego polecenia:
sudo usermod -aG plugdev $LOGNAME
Grupy są aktualizowane tylko podczas logowania, więc musisz wylogować się aby ta zmiana zaczęła obowiązywać. Gdy zalogujesz się z powrotem, możesz użyć aplikacji
id
, aby: Sprawdź, czy należysz do grupyplugdev
.- W systemie muszą być zainstalowane
udev
reguły, które obejmują urządzenie. Pakietandroid-sdk-platform-tools-common
zawiera obsługiwany przez społeczność domyślny zestaw regułudev
dla urządzeń z Androidem. Aby ją zainstalować, użyj tego polecenia:
apt-get install android-sdk-platform-tools-common
- Każdy użytkownik, który chce używać ADB, musi należeć do grupy
Połącz z urządzeniem przez USB
Gdy wszystko będzie gotowe i podłączone przez USB, kliknij Uruchom
w Android Studio, aby
skompilować i uruchomić aplikację na urządzeniu.
Za pomocą adb
możesz też wydawać polecenia.
w następujący sposób:
- Sprawdź, czy urządzenie jest połączone, uruchamiając polecenie
adb devices
z kataloguandroid_sdk/platform-tools/
. Jeśli urządzenia, zobaczysz je na liście. - Wyślij dowolne polecenie
adb
z flagę-d
, by kierować reklamy na urządzenie.
Połącz się z urządzeniem przez Wi-Fi
Android 11 i nowsze wersje obsługują bezprzewodowe wdrażanie i debugowanie aplikacji ze stacji roboczej za pomocą Android Debug Bridge (ADB). Możesz na przykład: wdrożyć aplikację możliwą do debugowania na wielu urządzeniach zdalnych bez fizycznego użycia podłączenie urządzenia przez USB i rozwiązywanie typowych problemów z połączeniem USB, np. instalacja sterownika.
Aby używać debugowania bezprzewodowego, musisz sparować urządzenie ze stacją roboczą za pomocą kodu parowania. Na początek wykonaj te czynności:
- Sprawdź, czy Twoja stacja robocza i urządzenie są połączone z tą samą siecią bezprzewodową
- Upewnij się, że na urządzeniu działa Android 11 lub nowszy. Więcej więcej informacji można znaleźć w sekcji Sprawdzanie Zaktualizuj Androida wersji.
- Upewnij się, że masz zainstalowaną najnowszą wersję Android Studio. Możesz go pobrać stąd.
- Na swojej stacji roboczej zaktualizuj aplikację Narzędzia platformy SDK
Aby połączyć się z urządzeniem, wykonaj te czynności:
- Otwórz Android Studio i wybierz z biegu opcję Paruj urządzenia przez Wi-Fi.
w menu konfiguracji.
Rysunek 1. Uruchom konfiguracje
Rysunek 2. Okno parowania urządzenia za pomocą kodu QR lub kodu parowania. - Włącz opcję programista opcje na swoim urządzeniu.
- Włącz debugowanie po
Wi-Fi
na swoim urządzeniu.
Rysunek 3. ustawienie Debugowanie bezprzewodowe na telefonie Google Pixel. telefonu. - Kliknij Debugowanie bezprzewodowe i sparuj urządzenie:
- Aby sparować urządzenie przy użyciu kodu QR, wybierz Sparuj urządzenie za pomocą kodu QR i zeskanuj kod QR, pokazany na rysunku 2.
- Aby sparować urządzenie przy użyciu kodu parowania, wybierz Sparuj urządzenie z
kodu parowania w oknie Parowanie nowych urządzeń przez Wi-Fi. Na urządzeniu
urządzenia, wybierz Sparuj za pomocą kodu parowania. Sześciocyfrowy
który pojawi się na ekranie. Gdy urządzenie pojawi się na
Okno Sparuj urządzenia przez Wi-Fi, wpisz 6-cyfrowe
wyświetlony na urządzeniu i wybierz Sparuj .
Rysunek 4. Przykład 6-cyfrowego formatu podając kod parowania.
- Po sparowaniu możesz spróbować wdrożyć aplikację na urządzeniu.
Aby sparować inne urządzenie lub zapomnieć to urządzenie na stacji roboczej:
- Otwórz Debugowanie bezprzewodowe na urządzeniu.
- W sekcji Sparowane urządzenia kliknij nazwę stacji roboczej.
- Wybierz Zapomnij.
Tworzenie odbicia lustrzanego urządzenia
W oknie Uruchomione urządzenia na Androidzie możesz powielić urządzenie fizyczne Studio. Dzięki strumieniowaniu obrazu z urządzenia bezpośrednio do Android Studio możesz: IDE Studio umożliwia wykonywanie typowych działań, takich jak uruchamianie aplikacji wchodzą z nimi w interakcję, obracają ekran, składają i rozkładają telefon. zmienianie głośności.
Powielanie ekranu jest zawsze dostępne, gdy są połączone urządzenia z komputerem z włączonym debugowaniem USB lub bezprzewodowym. Możesz uruchomić i zatrzymać odtwarzanie powielanie przy użyciu okna Uruchomione urządzenia lub Menedżera urządzeń. (Widok > Okna narzędzi > Menedżer urządzeń). Możesz też określić, kiedy urządzenie odbicie lustrzane jest włączone w ustawieniach (Ustawienia > Narzędzia > Dublowanie urządzenia).
Przekieruj dźwięk
Gdy korzystasz z powielania urządzenia, możesz przekierować dźwięk z podłączonego urządzenia urządzeń fizycznych do głośników lub słuchawek komputerowych. Z dźwiękiem podłączenie słuchawek do komputera i słuchanie ich z komputerem i połączonym telefonem bez konieczności ręcznego łączenia się z nim urządzenie, a potem kolejne. Aby włączyć przekierowanie audio, otwórz Plik (Android Studio w systemie macOS) > Ustawienia > Narzędzia > Powielanie urządzenia i wybierz Przekierowuj dźwięk z urządzeń lokalnych Pamiętaj, że dźwięk jest zawsze przekierowywany, niezależnie od ustawień w przypadku urządzeń z Laboratorium Firebase z Androidem 12 lub wyżej.
Znane problemy
Niektóre urządzenia mogą nie być w stanie kodować z wystarczającą szybkością transmisji bitów na potrzeby tworzenia odbicia lustrzanego. W takim przypadku w pliku cookie może pojawić się błąd Uruchomione urządzenia oraz dzienniki podobne do podanych poniżej.
2023-06-01 15:32:22,675 [ 56094] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - Too many video encoder errors:
2023-06-01 15:32:22,676 [ 56095] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - encoder: c2.android.vp8.encoder
2023-06-01 15:32:22,676 [ 56095] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - mime type: video/x-vnd.on2.vp8
2023-06-01 15:32:22,676 [ 56095] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max resolution: 640x640
2023-06-01 15:32:22,676 [ 56095] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - min resolution: 2x2
2023-06-01 15:32:22,676 [ 56095] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - alignment: 2x2
2023-06-01 15:32:22,676 [ 56095] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate: 960
2023-06-01 15:32:22,676 [ 56095] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate for 288x640: 960
2023-06-01 15:32:22,870 [ 56289] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max bitrate: 20000000
2023-06-01 15:32:22,871 [ 56290] WARN - ScreenSharingAgent Samsung SM-A045F API 33 - terminated with code 1
Informacje na temat ochrony prywatności
W zależności od ustawień odbicia lustrzanego urządzenia Android Studio może uruchomić się automatycznie
powielanie urządzeń na dowolnym połączonym i sparowanym urządzeniu. Może to spowodować
informacje dotyczące urządzeń połączonych z poleceniem adb tcpip
ponieważ powielane informacje i polecenia są przekazywane do niezaszyfrowanego
kanał. Dodatkowo Android Studio używa do komunikacji niezaszyfrowanego kanału
z serwerem adb, więc informacje powielane mogą być przechwytywane przez innych użytkowników.
na hoście.
Rozwiązywanie problemów z połączeniem urządzenia
Jeśli urządzenie nie łączy się z Android Studio, wykonaj te czynności, rozwiąż problem:
Rozwiązywanie problemów za pomocą Asystenta połączenia
Asystent połączeń podaje szczegółowe instrukcje, które pomogą Ci skonfigurować i używać urządzenia za pośrednictwem połączenia ADB.
Aby uruchomić asystenta, wybierz Narzędzia > Rozwiązywanie problemów z połączeniami z urządzeniami
Asystent połączenia podaje instrukcje, opcje kontroli w kontekście i listę połączonych urządzeń na serii stron w panelu Asystent. Użyj przyciskami Dalej i Wstecz u dołu panelu Asystent, aby: w razie potrzeby:
- Podłączanie urządzenia przez USB: na początku wyświetli się Asystent połączeń. możesz połączyć urządzenie przez USB i uzyskać dostęp do funkcji Ponownie przeskanuj urządzenia USB który pozwala rozpocząć nowe skanowanie w poszukiwaniu połączonych urządzeń.
- Włącz debugowanie USB: Asystent połączeń poinformuje Cię, jak włącz debugowanie USB w opcjach programisty na urządzeniu.
- Uruchom ponownie serwer ADB: jeśli nadal nie widzisz urządzenia na dostępnych urządzeń, kliknij przycisk Uruchom ponownie serwer ADB na ostatniej stronie Asystenta połączenia. Ponowne uruchomienie serwera ADB również powoduje ADB, aby ponownie przeskanować urządzenia w poszukiwaniu urządzeń. Jeśli urządzenia nadal nie ma na liście dostępnych urządzeń, spróbuj rozwiązać problem zgodnie z instrukcjami w następnej sekcji.
Rozwiązywanie problemów z połączeniem USB
Jeśli Asystent połączeń nie wykryje urządzenia przez USB, spróbuj wykonaj te czynności, by rozwiązać problem:
Sprawdzanie, czy Android Studio łączy się z emulatorem Androida
Aby sprawdzić, czy przyczyną problemu jest problem z połączeniem między Androidem W Studio i emulatorze Androida wykonaj te czynności:
- Otwórz Menedżera urządzeń.
- Utwórz nowy średni czas oglądania, jeśli jeszcze go nie masz. i tak je ma.
- Uruchom emulator za pomocą AVD.
- Wykonaj jedną z tych czynności:
- Jeśli Android Studio nie może połączyć się z emulatorem, pobierz najnowszą wersję Narzędzia platformy SDK i spróbuj jeszcze raz.
- Jeśli emulator się uruchomi, sprawdź kabel USB w sposób opisany w następnej sekcji.
Sprawdź kabel USB
Aby sprawdzić, czy przyczyną problemu jest uszkodzony kabel USB, wykonaj czynności opisane w w tej sekcji.
Jeśli masz inny kabel USB:
- Podłącz urządzenie za pomocą drugiego kabla.
- Sprawdź, czy Asystent połączeń może teraz wykryć urządzenie.
- Jeśli urządzenie nie zostanie wykryte, spróbuj ponownie użyć kabla głównego.
- Jeśli urządzenie nadal nie zostanie wykryte, załóżmy, że problem dotyczy urządzenia oraz sprawdź, czy urządzenie jest skonfigurowane do programowania jak opisano w następnej sekcji.
Jeśli nie masz innego kabla USB, ale masz inne urządzenie z Androidem:
- Podłącz dodatkowe urządzenie do komputera.
Jeśli Asystent połączenia może wykryć urządzenie dodatkowe, występuje problem z urządzeniem głównym. sprawdź, czy urządzenie jest skonfigurowane do programowania.
Jeśli dodatkowe urządzenie nie zostanie wykryte, problem może dotyczyć USB za pomocą kabla.
Sprawdzanie, czy urządzenie jest skonfigurowane do programowania
Aby sprawdzić, czy przyczyną problemu są ustawienia urządzenia, wykonaj te czynności: kroki:
- Wykonaj czynności opisane w artykule Konfigurowanie urządzenia na potrzeby programowania. .
- Jeśli to nie rozwiąże problemu, skontaktuj się z producentem urządzenia. z obsługą klienta. Poinformuj przedstawiciela działu obsługi klienta, że urządzenie nie łączy się z Android Studio przez ADB.
Rozwiązywanie problemów z połączeniem bezprzewodowym
Jeśli masz problemy z bezprzewodowym połączeniem się z urządzeniem, wypróbuj wykonaj te czynności, by rozwiązać problem:
Sprawdź, czy Twoja stacja robocza i urządzenie spełniają wymagania wstępne
Aby spełnić wymagania wstępne dotyczące debugowania bezprzewodowego, upewnij się, że:
- Twoja stacja robocza i urządzenie są połączone z tą samą siecią bezprzewodową.
- na urządzeniu działa Android 11 lub nowszy, Więcej informacji: Czek i Zaktualizuj Androida wersji.
- Masz najnowszą wersję Android Studio. Możesz pobrać go na stronie głównej Android Studio.
- Masz najnowszą wersję Narzędzia platformy SDK na Twojej stacji roboczej.
Sprawdź, czy nie wystąpiły inne znane problemy
Poniżej znajduje się lista znanych obecnie problemów z debugowaniem bezprzewodowym w Android Studio i sposoby rozwiązywania problemów:
- Wi-Fi nie łączy się: niektóre sieci Wi-Fi, na przykład firmowe Wi-Fi. sieci, mogą blokować połączenia p2p i uniemożliwiać łączenie się przez Wi-Fi. Spróbuj połączyć się za pomocą kabla lub innej sieci Wi-Fi.
- ADB przez Wi-Fi czasami wyłącza się automatycznie: może się tak zdarzyć, jeśli urządzenie przełącza się na sieć Wi-Fi albo rozłącza się.
Klucz bezpieczeństwa RSA
Gdy połączysz urządzenie z Androidem 4.2.2 (poziom interfejsu API 17) lub nowszym
komputer, system wyświetla okno z pytaniem, czy zaakceptować klucz RSA, który
umożliwia debugowanie na tym komputerze. Ten mechanizm zabezpieczający chroni użytkowników
urządzeń, ponieważ debugowanie USB i inne polecenia adb
nie mogą być
wykonywane, chyba że uda Ci się odblokować urządzenie i potwierdzić okno.