Uruchamianie aplikacji na urządzeniu sprzętowym

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:

1. Na urządzeniu otwórz aplikację Ustawienia, wybierz Opcje programisty. i włącz Debugowanie USB (w razie potrzeby).

2. 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 grupy plugdev.

     • W systemie muszą być zainstalowane udev reguły, które obejmują urządzenie. Pakiet android-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
     

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 katalogu android_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:

1. Sprawdź, czy Twoja stacja robocza i urządzenie są połączone z tą samą siecią bezprzewodową
2. 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.
3. Upewnij się, że masz zainstalowaną najnowszą wersję Android Studio. Możesz go pobrać stąd.
4. Na swojej stacji roboczej zaktualizuj aplikację Narzędzia platformy SDK

Aby połączyć się z urządzeniem, wykonaj te czynności:

1. Otwórz Android Studio i wybierz z biegu opcję Paruj urządzenia przez Wi-Fi. w menu konfiguracji.

   

   
   
   Pojawi się okno Paruj urządzenia przez Wi-Fi, tak jak na ilustracji 2.

   

2. Włącz opcję programista opcje na swoim urządzeniu.
3. Włącz debugowanie po Wi-Fi na swoim urządzeniu.

   

4. Kliknij Debugowanie bezprzewodowe i sparuj urządzenie:
   1. 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.
   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 .

      

5. 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:

1. Otwórz Debugowanie bezprzewodowe na urządzeniu.
2. W sekcji Sparowane urządzenia kliknij nazwę stacji roboczej.
3. 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ższe.

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, aby informacje powielane mogły zostać przechwycone 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:

1. Otwórz Menedżera urządzeń.
2. Utwórz nowy średni czas oglądania, jeśli jeszcze go nie masz. i tak je ma.
3. Uruchom emulator za pomocą AVD.
4. 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:

1. Podłącz urządzenie za pomocą drugiego kabla.
2. Sprawdź, czy Asystent połączeń może teraz wykryć urządzenie.
3. Jeśli urządzenie nie zostanie wykryte, spróbuj ponownie użyć kabla głównego.
4. 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:

1. Podłącz dodatkowe urządzenie do komputera.

2. 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:

1. Wykonaj czynności opisane w artykule Konfigurowanie urządzenia na potrzeby programowania. .
2. 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.