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 ekranach o różnych rozmiarach, użyj Emulatora Androida. Rozważ skorzystanie z Laboratorium Firebase, aby uruchomić aplikację na wielu różnych prawdziwych urządzeniach hostowanych w infrastrukturze w 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 programisty i włącz Debugowanie USB (w razie potrzeby).

   Uwaga: jeśli nie widzisz Opcje 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 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 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.

Połącz się 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. Sprawdź, czy Twoja 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 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 z kodem QR i zeskanuj kod QR, jak pokazano na ilustracji 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 wyświetlony 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. W sekcji Sparowane urządzenia kliknij nazwę stacji roboczej.
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 korzystasz z odbicia lustrzanego urządzenia, możesz przekierować dźwięk z połączonych urządzeń fizycznych na głośniki lub słuchawki komputera. 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 > Odzwierciedlenie urządzenia i wybierz Przekierowywanie dźwięku z urządzeń lokalnych. Pamiętaj, że w przypadku urządzeń z Laboratorium Firebase z Androidem 12 lub nowszym 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 lustrach 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ą Asystenta połączenia

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 podaje instrukcje, elementy sterujące w kontekście oraz 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: Asystent połączeń poprosi o podłączenie urządzenia przez USB i wyświetli przycisk Przeskanuj ponownie urządzenia USB, który pozwala rozpocząć nowe skanowanie w poszukiwaniu połą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ń, na ostatniej stronie kreatora połączenia kliknij przycisk Uruchom ponownie serwer ADB. Ponowne uruchomienie serwera ADB także powoduje ponowne skanowanie w poszukiwaniu urządzeń. Jeśli nadal nie widzisz swojego urządzenia na liście dostępnych urządzeń, wykonaj czynności opisane w sekcji poniżej.

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 jest spowodowany problemem z połączeniem między Android Studio a Android Emulatorem:

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.

Sprawdź kabel USB

Aby sprawdzić, czy przyczyną problemu jest uszkodzony kabel 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.

Sprawdzanie, czy urządzenie jest skonfigurowane do programowania

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ć ze strony głównej Android Studio.
• Masz na stacji roboczej najnowszą wersję narzędzi platformy SDK.

Sprawdzanie innych znanych problemów

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

• Wi-Fi nie łączy się: niektóre sieci Wi-Fi, na przykład firmowe, 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ę to zdarzyć, gdy urządzenie przełączy się na inną sieć Wi-Fi lub rozłączy się z siecią.

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.