Uruchamianie aplikacji na urządzeniu sprzętowym

Przed udostępnieniem aplikacji użytkownikom zawsze testuj ją na prawdziwym urządzeniu. Na tej stronie znajdziesz informacje o konfigurowaniu środowiska programistycznego i urządzenia z Androidem na potrzeby testowania i debugowania za pomocą połączenia Android Debug Bridge (ADB).

Uwaga: aby przetestować aplikację w różnych wersjach platformy Android i na różnych rozmiarach ekranu, użyj Emulatora Androida. 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 wykonaj te czynności:

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 Opcji programisty, wykonaj instrukcje włączania opcji programisty.

2. Skonfiguruj system tak, aby wykrywał urządzenie.

   • ChromeOS: nie wymaga dodatkowej konfiguracji.
   • macOS: nie wymaga dodatkowej konfiguracji.
   • Windows: zainstaluj sterownik USB dla ADB (w stosownych przypadkach). 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 korzystać z 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 po zalogowaniu się, więc musisz się wylogować, aby ta zmiana zaczęła obowiązywać. Po zalogowaniu się możesz użyć id, aby sprawdzić, 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 domyślny zestaw reguł udev dla urządzeń z Androidem, który jest utrzymywany przez społeczność. Aby go 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 Uruchom w Android Studio, aby skompilować i uruchomić aplikację na urządzeniu.

Możesz też wydawać polecenia za pomocą adb w ten sposób:

• Sprawdź, czy urządzenie jest połączone, uruchamiając polecenie adb devices z katalogu android_sdk/platform-tools/. Jeśli jest połączone, zobaczysz je na liście.
• Aby ustawić urządzenie jako urządzenie docelowe, wydaj dowolne polecenie adb z flagą -d.

Łą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ę do debugowania na wielu urządzeniach zdalnych bez fizycznego podłączania urządzenia przez USB i rozwiązywania typowych problemów z połączeniem USB, takich jak instalacja sterownika.

Aby korzystać z debugowania bezprzewodowego, musisz sparować urządzenie z stanowiskiem roboczym za pomocą kodu parowania. Aby rozpocząć, 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 informacji znajdziesz w artykule Sprawdzanie i aktualizowanie wersji Androida.
3. Upewnij się, że masz zainstalowaną najnowszą wersję Android Studio. Możesz go pobrać stąd.
4. Na stacji roboczej zaktualizuj narzędzia platformy SDK do najnowszej wersji.

Aby połączyć się z urządzeniem:

1. Otwórz Android Studio i w menu Konfiguracje uruchomienia wybierz Pair Devices Using Wi-Fi (Parowanie urządzeń za pomocą Wi-Fi).

   

   Rysunek 1. Konfiguracje uruchomienia w menu.

   
   
   Pojawi się okno Sparuj urządzenia przez Wi-Fi, jak pokazano na rysunku 2.

   

   Rysunek 2. Dialog do parowania urządzeń za pomocą kodu QR lub kodu parowania

2. Włącz opcje dla deweloperów na urządzeniu.
3. Na urządzeniu włącz debugowanie przez Wi-Fi.

   

   Rysunek 3. Ustawienie Debugowanie bezprzewodowe na telefonie Google Pixel.

4. Kliknij Debugowanie przez Wi-Fi i sparuj urządzenie:
   1. Aby sparować urządzenie z kodem QR, wybierz Sparuj urządzenie przy pomocy kodu QR i zeskanuj kod QR, jak pokazano 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 wybierz Paruj za pomocą kodu parowania. Pojawi się 6-cyfrowy kod. Gdy urządzenie pojawi się w oknie Parowanie urządzeń przez Wi-Fi, wpisz sześciocyfrowy kod widoczny na urządzeniu i kliknij Paruj .

      

      Rysunek 4. Przykład wpisywania sześciocyfrowego kodu parowania

5. Po sparowaniu możesz spróbować wdrożyć aplikację na urządzeniu.

Aby sparować inne urządzenie lub usunąć to urządzenie z stanowiska roboczego:

1. Na urządzeniu otwórz Debugowanie bezprzewodowe.
2. Kliknij nazwę stacji roboczej w sekcji Sparowane urządzenia.
3. Kliknij Zapomnij.

Odbicie lustrzane ekranu

Możesz wyświetlać zduplikowany obraz urządzenia fizycznego w oknie Urządzenia w użyciu w Android Studio. Dzięki transmisji ekranu 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.

Lustrowanie ekranu jest zawsze dostępne, gdy do komputera są podłączone urządzenia z włączonym debugowaniem przez USB lub bezprzewodowo. Odzwierciedlanie możesz rozpocząć i zatrzymać za pomocą okna Urządzenia w działaniu 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 używasz określonych urządzeń, takich jak Xiaomi Redmi K40, Poco F3 lub Mi 11X z Androidem 12, musisz włączyć ustawienia Debugowanie przez USB i Debugowanie przez USB (Ustawienia zabezpieczeń), a następnie ponownie uruchomić urządzenie, aby włączyć dublowanie ekranu.

Przekierowanie dźwięku

Gdy używasz funkcji dublowania ekranu, możesz przekierowywać dźwięk z podłączonych urządzeń fizycznych na głośniki komputera lub słuchawki. 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ć przekierowywanie dźwięku, kliknij Plik (Android Studio w systemie macOS) > Ustawienia > Narzędzia > Odzwierciedlanie urządzenia i wybierz Przekierowywanie dźwięku z urządzeń lokalnych. Pamiętaj, że na urządzeniach z Laboratorium Firebase z Androidem w wersji 12 lub nowszej dźwięk jest zawsze przekierowywany niezależnie od ustawień.

Znane problemy

Niektóre urządzenia mogą nie być w stanie kodować z bitratem wystarczającym do obsługi dublowania ekranu. W takich sytuacjach w oknie Urządzenia w trybie działania może pojawić się błąd, a w logach komunikat podobny do tego 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ć ujawnienie informacji na urządzeniach połączonych z poleceniem adb tcpip, ponieważ informacje i polecenia dotyczące dublowania są przekazywane przez niezaszyfrowany kanał. Ponadto Android Studio używa niezaszyfrowanego kanału do komunikacji z serwerem adb, więc informacje o lustracji mogą być przechwytywane przez innych użytkowników na Twoim komputerze.

Rozwiązywanie problemów z połączeniem urządzenia

Jeśli urządzenie nie łączy się z Android Studio, wykonaj te czynności, aby rozwiązać problem:

Rozwiązywanie problemów za pomocą narzędzia do rozwiązywania problemów z połączeniem

Asystent połączenia zawiera szczegółowe instrukcje konfigurowania i korzystania z urządzenia przez połączenie ADB.

Aby uruchomić asystenta, kliknij Narzędzia > Rozwiązywanie problemów z połączeniem z urządzeniem.

Asystent połączenia zawiera instrukcje, elementy sterujące 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:

• Połącz urządzenie przez USB: najpierw pojawi się komunikat z prośbą o podłączenie urządzenia przez USB i przycisk Ponowne skanowanie urządzeń USB, za pomocą którego można rozpocząć nowe skanowanie podłączonych urządzeń.
• Włącz debugowanie USB: w tym celu kliknij „Pomóż mi połączyć się z urządzeniem”.
• Uruchom ponownie serwer ADB: jeśli urządzenie nadal nie pojawia się na liście dostępnych urządzeń, kliknij przycisk Restart ADB server (Uruchom ponownie serwer ADB) na ostatniej stronie kreatora połączenia. Ponowne uruchomienie serwera ADB powoduje ponowne skanowanie urządzeń. Jeśli urządzenie nadal nie pojawia się na liście dostępnych urządzeń, wykonaj czynności opisane w następnej sekcji.

Rozwiązywanie problemów z połączeniem USB

Jeśli narzędzie do łączenia nie wykryje urządzenia przez USB, wykonaj te czynności:

Sprawdź, czy Android Studio łączy się z Emulatorem Androida

Aby sprawdzić, czy problem nie jest spowodowany problemem z połączeniem między Android Studio a emulatorem Androida:

1. Otwórz Menedżera urządzeń.
2. Utwórz nowe AVD, jeśli jeszcze go nie masz.
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ędzi platformy SDK, a potem spróbuj ponownie.
   • Jeśli emulacja zostanie uruchomiona, sprawdź kabel USB w sposób opisany w następującej 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ą dodatkowego kabla.
2. Sprawdź, czy Asystent połączenia 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łóż, ż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 drugie urządzenie do komputera.

2. Jeśli narzędzie do obsługi połączeń wykryje urządzenie dodatkowe, problem występuje na urządzeniu głównym. Sprawdź, czy urządzenie jest skonfigurowane do tworzenia aplikacji.

   Jeśli urządzenie dodatkowe nie zostanie wykryte, problem może dotyczyć kabla USB.

Sprawdź, czy urządzenie jest skonfigurowane do tworzenia aplikacji

Aby sprawdzić, czy problem nie jest spowodowany ustawieniami urządzenia, wykonaj te czynności:

1. Wykonaj czynności opisane w sekcji Konfigurowanie urządzenia do celów programistycznych.
2. Jeśli to nie rozwiąże problemu, skontaktuj się z zespołem obsługi klienta producenta urządzenia, aby uzyskać pomoc. Poinformuj pracownika obsługi klienta, że urządzenie nie łączy się z Android Studio za pomocą ADB.

Rozwiązywanie problemów z połączeniem bezprzewodowym

Jeśli masz problemy z połączeniem bezprzewodowym z urządzeniem, wykonaj te czynności:

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:

• Stacja robocza i urządzenie są połączone z tą samą siecią bezprzewodową.
• urządzenie z Androidem 11 lub nowszym, 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 najnowszą wersję narzędzi platformy pakietu SDK na stacji roboczej.

Sprawdzanie innych znanych problemów

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

• Nie można połączyć się przez Wi-Fi: niektóre sieci Wi-Fi, np. sieci Wi-Fi firmowe, mogą blokować połączenia p2p i nie pozwalać na połączenie 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 zabezpieczeń chroni urządzenia użytkowników, ponieważ debugowanie przez USB i inne polecenia adb nie mogą być wykonywane, dopóki nie odblokujesz urządzenia i nie potwierdzisz wyświetlonego okna dialogowego.