Uruchamianie aplikacji na urządzeniu sprzętowym

Przed udostępnieniem aplikacji użytkownikom zawsze testuj ją na prawdziwym urządzeniu. Na tej stronie opisaliśmy, jak skonfigurować środowisko programistyczne i urządzenie z Androidem do testowania i debugowania za pomocą połączenia Android Debug Bridge (ADB).

Uwaga: do testowania aplikacji użyj emulatora Androida różnych wersji platformy Androida i różnych rozmiarów ekranu. Rozważ użycie Laboratorium Firebase do uruchomienia aplikacji na wielu różnych prawdziwych urządzeniach hostowanych w infrastrukturze opartej na chmurze.

Konfigurowanie urządzenia do celów programistycznych

Zanim zaczniesz debugowanie na urządzeniu, zdecyduj, czy chcesz połączyć się z nim za pomocą kabla USB czy Wi-Fi. Następnie:

1. Na urządzeniu otwórz aplikację Ustawienia, wybierz Opcje programistyczne, a następnie włącz Debugowanie przez USB (jeśli jest dostępne).

   Uwaga: jeśli nie widzisz Opcje programisty, wykonaj instrukcje, aby włączyć opcje programisty.

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). Przewodnik po instalacji i linki do sterowników OEM znajdziesz w artykule Instalowanie sterowników OEM USB.

   • Ubuntu Linux: skonfiguruj te elementy:

     • Każdy użytkownik, który chce używać ADB, musi należeć do grupy plugdev. Jeśli zobaczysz komunikat o błędzie informujący, że nie należysz do grupy plugdev, dodaj się do niej za pomocą tego polecenia:

     sudo usermod -aG plugdev $LOGNAME
     

     Grupy są aktualizowane tylko podczas logowania, więc musisz wylogować się ta zmiana wejdzie w życie. Gdy zalogujesz się z powrotem, możesz użyć aplikacji id, aby: Sprawdź, czy należysz do grupy plugdev.

     • System musi mieć zainstalowane reguły udev, które obejmują dane 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
     

Łączenie z urządzeniem za pomocą kabla USB

Po zakończeniu konfiguracji i podłączeniu urządzenia przez USB kliknij Uruchomw 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.

Łączenie z urządzeniem przez Wi-Fi

Android 11 i nowsze obsługuje bezprzewodowe wdrażanie i debugowanie aplikacji z stanowiska roboczego 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 korzystać z debugowania bezprzewodowego, musisz sparować urządzenie z stanowiskiem roboczym za pomocą kodu parowania. Na początek wykonaj te czynności:

1. Upewnij się, że stacja robocza i urządzenie są połączone z tą samą siecią bezprzewodową.
2. Upewnij się, że na urządzeniu jest zainstalowany 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.

   

   Rysunek 1. Konfiguracje uruchomień w menu.

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

   

   Rysunek 2. Okno parowania urządzenia za pomocą kodu QR lub kodu parowania.

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

   

   Rysunek 3. Ustawienie Debugowanie przez Wi-Fi na telefonie Google Pixel

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, w oknie Sparuj nowe urządzenia przez Wi-Fi kliknij Sparuj urządzenie przy pomocy kodu parowania. 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.

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. Kliknij nazwę stacji roboczej w sekcji Sparowane urządzenia.
3. Kliknij Zapomnij.

Odbicie lustrzane ekranu

W oknie Uruchomione urządzenia na Androidzie możesz powielić urządzenie fizyczne Studio. Dzięki transmisji wyświetlacza urządzenia bezpośrednio do Android Studio możesz używać samego środowiska IDE Studio do wykonywania typowych czynności, takich jak uruchamianie aplikacji i interakcja z nimi, obracanie ekranu, składanie i rozkładanie telefonu oraz zmiana 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ń). W ustawieniach urządzenia możesz też określić, kiedy ma być włączone dublowanie ekranu (Ustawienia > Narzędzia > Dublowanie ekranu).

Uwaga: jeśli korzystasz z określonych urządzeń, takich jak Xiaomi Redmi K40, Poco F3 lub Mi 11X w Androidzie 12 musisz włączyć zarówno debugowanie USB, jak i Ustawienia Debugowania USB (Ustawienia zabezpieczeń), a następnie ponownie uruchom urządzenie, aby włącz odbicie lustrzane urządzenia.

Przekierowanie dźwięku

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. Dzięki przekierowywaniu dźwięku możesz podłączyć słuchawki do komputera i słuchać dźwięku zarówno z komputera, jak i z podłączonego telefonu, bez konieczności ręcznego ponownego łączenia się z jednym i drugim urządzeniem. 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 takich sytuacjach w oknie Urządzenia w trakcie działania może pojawić się błąd, a także dzienniki podobne do tych 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

Na podstawie ustawień dublowania ekranu Android Studio może automatycznie rozpocząć dublowanie ekranu na dowolnym podłą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ą narzędzia do rozwiązywania problemów z połączeniem

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łączeniem z urządzeniem.

Asystent połączenia podaje instrukcje, opcje kontroli w kontekście i listę połączonych urządzeń na serii stron w panelu Asystent. Użyj przycisków Dalej i Wstecz u dołu panelu Asystent, aby przechodzić między stronami:

• Podłączanie urządzenia przez USB: najpierw poprosi o pomoc Asystenta 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 urządzenie nadal nie pojawia się na liście dostępnych urządzeń, na ostatniej stronie kreatora połączenia kliknij przycisk Uruchom ponownie serwer ADB. 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.

Sprawdzanie kabla USB

Aby sprawdzić, czy problem nie jest spowodowany wadliwym kablem USB, wykonaj czynności opisane 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 podstawowego.
4. Jeśli urządzenie nadal nie zostanie wykryte, załóż, że problem dotyczy urządzenia, i sprawdź, czy urządzenie jest skonfigurowane do tworzenia aplikacji zgodnie z opisem 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 znajdziesz w artykule Sprawdzanie i aktualizowanie wersji Androida.
• Masz najnowszą wersję Android Studio. Możesz go pobrać na głównej stronie Androida Studio.
• Masz na stacji roboczej najnowszą wersję narzędzi platformy pakietu SDK.

Sprawdź, czy nie wystąpiły inne znane problemy

Poniżej znajdziesz listę znanych problemów z bezprzewodowym debugowaniem w Android Studio oraz sposoby ich rozwiązywania:

• 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.
• Protokół ADB przez Wi-Fi czasami wyłącza się automatycznie: może się tak zdarzyć, jeśli urządzenie przełączy się na inną sieć Wi-Fi lub się z nią rozłączy.

Klucz bezpieczeństwa RSA

Gdy połączysz z komputera urządzenie z Androidem 4.2.2 (poziom interfejsu API 17) lub nowszym, system wyświetli okno z zapytaniem, czy chcesz 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.