Uruchamianie aplikacji na urządzeniu sprzętowym

Zawsze przetestuj aplikację na Androida na prawdziwym urządzeniu, zanim udostępnisz ją użytkownikom. Na tej stronie dowiesz się, jak skonfigurować środowisko programistyczne i urządzenie z Androidem do testowania i debugowania przez połączenie Android Debug Bridge (ADB).

Konfigurowanie urządzenia do programowania

Zanim zaczniesz debugować 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 programisty, a następnie włącz Debugowanie USB (jeśli dotyczy).

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

    • ChromeOS: nie jest wymagana dodatkowa konfiguracja.
    • macOS: nie jest wymagana żadna dodatkowa konfiguracja.
    • Windows: zainstaluj sterownik do USB dla ADB (jeśli dotyczy). Instrukcje instalacji i linki do sterowników OEM znajdziesz w artykule Instalowanie sterowników USB OEM.
    • Ubuntu Linux: skonfiguruj te ustawienia:

      • 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 podczas logowania, więc aby ta zmiana została wprowadzona, musisz się wylogować. Po ponownym zalogowaniu się możesz użyć polecenia id, aby sprawdzić, czy jesteś w grupie plugdev.

      • W systemie muszą być zainstalowane reguły udev, które obejmują 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 przez USB

Po skonfigurowaniu i podłączeniu urządzenia przez USB kliknij Uruchom  w Android Studio, aby utworzyć i uruchomić aplikację na urządzeniu.

Możesz też używać adb do wydawania poleceń 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.
  • Uruchom dowolne polecenie adb z flagą -d, aby wybrać urządzenie.

Łączenie z urządzeniem przez Wi-Fi

Android 11 i nowsze wersje obsługują wdrażanie i debugowanie aplikacji bezprzewodowo ze stacji roboczej za pomocą Android Debug Bridge (ADB). Możesz na przykład wdrożyć aplikację z możliwością 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 sterowników.

Android 17 wraz z adb 37.0.0 wprowadza adb Wi-Fi 2.0, które rozwiązuje wiele problemów z użytecznością poprzedniej wersji. Urządzenie automatycznie połączy się ze stacją roboczą, gdy połączy się z zaufaną siecią debugowania bezprzewodowego.

Aby korzystać z debugowania bezprzewodowego, musisz sparować urządzenie ze stacją roboczą 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. Sprawdź, czy masz zainstalowaną najnowszą wersję Android Studio. Pobierz go tutaj
  4. Na stacji roboczej zaktualizuj narzędzia platformy SDK do najnowszej wersji.

Aby sparować urządzenie, wykonaj te czynności:

  1. Włącz na urządzeniu opcje programisty.
  2. Na urządzeniu kliknij Debugowanie bezprzewodowe.

    Telefon Pixel z wyświetlonym monitem o debugowanie bezprzewodowe.
    Rysunek 1. Prośba o debugowanie bezprzewodowe na telefonie Google Pixel.

  3. Zezwól na debugowanie bezprzewodowe w sieci. Pamiętaj, że kliknięcie pola wyboru Zawsze zezwalaj w tej sieci spowoduje, że sieć stanie się zaufaną siecią do debugowania bezprzewodowego. Urządzenie będzie zawsze zezwalać na debugowanie bezprzewodowe w tej sieci, gdy tylko się z nią połączy.

    Telefon Pixel z wyświetlonym ustawieniem systemowym debugowania bezprzewodowego.
    Rysunek 2. Ustawienie Debugowanie bezprzewodowe na telefonie Google Pixel.

  4. Otwórz Android Studio i w menu konfiguracji uruchamiania wybierz Sparuj urządzenia przez Wi-Fi.

    Menu konfiguracji uruchamiania
    Rysunek 3. Konfiguracje uruchamiania.

  5. Pojawi się okno Parowanie urządzeń przez Wi-Fi, jak pokazano na rysunku 4.

    Wyskakujące okienko parowania urządzeń przez Wi-Fi
    Rysunek 4. Okno do parowania urządzeń przez Wi-Fi.

    Możesz też sparować urządzenie w Menedżerze urządzeń. Przykład: My Pixel.

    Menedżer urządzeń z urządzeniem dostępnym do sparowania przez Wi-Fi
    Rysunek 5. Menedżer urządzeń z urządzeniem dostępnym do parowania przez Wi-Fi.

  6. Kliknij Pair na urządzeniu, które chcesz sparować. Pojawi się okno parowania urządzeń.

    1. Aby sparować urządzenie za pomocą kodu QR, wybierz Sparuj urządzenie za pomocą kodu QR i zeskanuj kod QR.
      Wyskakujące okienko parowania urządzeń przez Wi-Fi
      Rysunek 6. Okno parowania urządzenia za pomocą kodu QR.
    2. Aby sparować urządzenie za pomocą kodu parowania, w oknie Sparuj nowe urządzenia przez Wi-Fi wybierz Sparuj urządzenie za pomocą kodu parowania. Na urządzeniu wybierz Sparuj za pomocą kodu parowania. Pojawi się 6-cyfrowy kod. Gdy urządzenie pojawi się w oknie Parowanie urządzeń przez Wi-Fi, wpisz 6-cyfrowy kod wyświetlany na urządzeniu i wybierz Sparuj.
      Przykładowy wpis kodu parowania
      Rysunek 7. Przykład wpisywania 6-cyfrowego kodu parowania.
  7. Po sparowaniu możesz spróbować wdrożyć aplikację na urządzeniu.

Aby rozparować stację roboczą, na urządzeniu otwórz Debugowanie bezprzewodowe. W sekcji Sparowane urządzenia kliknij nazwę stacji roboczej i wybierz Zapomnij. Możesz też kliknąć Unieważnij autoryzacje debugowania ADB na stronie ustawień urządzenia, aby rozparować stację roboczą i wszystkie inne wcześniej sparowane stacje robocze.

Dublowanie urządzenia

Możesz odzwierciedlić urządzenie fizyczne w oknie Uruchomione urządzenia w Android Studio. Dzięki strumieniowemu przesyłaniu obrazu z urządzenia bezpośrednio do Android Studio możesz używać środowiska IDE Studio do wykonywania typowych działań, takich jak uruchamianie aplikacji i interakcja z nimi, obracanie ekranu, składanie i rozkładanie telefonu oraz zmienianie głośności.

Odzwierciedlanie urządzenia jest zawsze dostępne, gdy do komputera są podłączone urządzenia z włączonym debugowaniem przez USB lub debugowaniem bezprzewodowym. Możesz rozpocząć i zatrzymać odbicie lustrzane w oknie Uruchomione urządzenia lub w Menedżerze urządzeń (Widok > Okna narzędzi > Menedżer urządzeń). Możesz też dostosować moment aktywacji odbicia lustrzanego urządzenia w ustawieniach (Ustawienia > Narzędzia > Odbicie lustrzane urządzenia).

Odbicie lustrzane urządzenia w oknie Uruchomione urządzenia w Android Studio
Rysunek 8. Uruchomione urządzenia.

Przekierowująca kreacja audio

Gdy korzystasz z odbicia lustrzanego urządzenia, możesz przekierować dźwięk z połączonych urządzeń fizycznych na głośniki komputera lub słuchawki. Dzięki przekierowaniu dźwięku możesz mieć słuchawki podłączone do komputera i słuchać dźwięku zarówno z komputera, jak i z połączonego telefonu, bez konieczności ręcznego przełączania się między urządzeniami. Aby włączyć przekierowywanie dźwięku, kliknij Plik (Android Studio w systemie macOS) > Ustawienia > Narzędzia > Odbicie lustrzane urządzenia i wybierz Przekieruj dźwięk z urządzeń lokalnych. Pamiętaj, że dźwięk jest zawsze przekierowywany, niezależnie od ustawień, w przypadku urządzeń Laboratorium Firebase z Androidem 12 lub nowszym.

Znane problemy

Niektóre urządzenia mogą nie być w stanie kodować z szybkością transmisji bitów wystarczającą do obsługi odbicia lustrzanego urządzenia. W takich sytuacjach w oknie Uruchomione urządzenia 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ń odbicia lustrzanego urządzenia Android Studio może automatycznie rozpocząć odbicie lustrzane dowolnego połączonego i sparowanego urządzenia. Może to spowodować ujawnienie informacji dotyczących urządzeń połączonych za pomocą polecenia adb tcpip, ponieważ informacje i polecenia dotyczące dublowania są przesyłane przez niezaszyfrowany kanał. Dodatkowo Android Studio używa niezaszyfrowanego kanału do komunikacji z serwerem adb, więc informacje o odbiciu lustrzanym mogą zostać przechwycone przez innych użytkowników na komputerze hosta.

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

Jeśli urządzenie nie łączy się z Android Studio, spróbuj rozwiązać problem, wykonując te czynności:

Rozwiązywanie problemów za pomocą Asystenta połączeń

Asystent połączenia zawiera szczegółowe instrukcje, które pomogą Ci skonfigurować urządzenie i korzystać z niego przez połączenie ADB.

Aby uruchomić asystenta, wybierz Tools (Narzędzia) > Troubleshoot Device Connections (Rozwiązywanie problemów z połączeniami urządzeń).

Asystent połączenia zawiera instrukcje, elementy sterujące w kontekście i listę połączonych urządzeń na kilku stronach 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: asystent połączenia najpierw poprosi Cię o podłączenie urządzenia przez USB i wyświetli przycisk Ponownie przeskanuj urządzenia USB, za pomocą którego możesz rozpocząć nowe skanowanie w poszukiwaniu połączonych urządzeń.
  • Włącz debugowanie USB: asystent połączenia poinformuje Cię, jak włączyć debugowanie USB w opcjach programisty na urządzeniu.
  • Uruchom ponownie serwer ADB: jeśli nadal nie widzisz urządzenia na liście dostępnych urządzeń, użyj przycisku Uruchom ponownie serwer ADB na ostatniej stronie asystenta połączenia. Ponowne uruchomienie serwera ADB powoduje też, że ADB ponownie skanuje w poszukiwaniu urządzeń. Jeśli nadal nie widzisz swojego urządzenia na liście dostępnych urządzeń, spróbuj wykonać czynności opisane w następnej sekcji rozwiązywania problemów.

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

Jeśli asystent połączenia nie wykrywa urządzenia przez USB, spróbuj rozwiązać problem, wykonując te czynności:

Sprawdzanie, czy Android Studio łączy się z Android Emulatorem

Aby sprawdzić, czy problem jest spowodowany przez błąd połączenia między Android Studio a Android Emulatorem, wykonaj te czynności:

  1. Otwórz Menedżera urządzeń.
  2. Utwórz nowe urządzenie AVD, jeśli jeszcze go nie masz.
  3. Uruchom emulator, używając AVD.
  4. Wykonaj jedną z tych czynności:
    • Jeśli Android Studio nie może połączyć się z emulatorem, pobierz najnowsze narzędzia platformy SDK i spróbuj ponownie.
    • Jeśli emulator uruchomi się prawidłowo, sprawdź kabel USB zgodnie z opisem w następnej sekcji.

Sprawdzanie kabla USB

Aby sprawdzić, czy problem jest spowodowany przez 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 jest wykrywane, załóż, że problem dotyczy urządzenia, i sprawdź, czy jest ono 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 urządzenie dodatkowe do komputera.
  2. Jeśli asystent połączenia wykryje urządzenie dodatkowe, załóż, że problem dotyczy urządzenia głównego, i sprawdź, czy jest ono skonfigurowane do programowania.

    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 jest spowodowany przez ustawienia na urządzeniu, wykonaj te czynności:

  1. Wykonaj czynności opisane w sekcji Konfigurowanie urządzenia do programowania.
  2. Jeśli to nie rozwiąże problemu, skontaktuj się z obsługą klienta producenta urządzenia, aby uzyskać pomoc. Poinformuj pracownika obsługi klienta, że urządzenie nie łączy się z Androidem Studio przez ADB.

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

Jeśli masz problemy z bezprzewodowym połączeniem z urządzeniem, spróbuj je rozwiązać, wykonując te czynności:

Sprawdzanie, czy stacja robocza i urządzenie spełniają wymagania wstępne

Sprawdź, czy stacja robocza i urządzenie spełniają wymagania wstępne.

Zapoznaj się z przewodnikiem rozwiązywania problemów z adb

Postępuj zgodnie z przewodnikiem rozwiązywania problemów z adb.

Klucz bezpieczeństwa RSA

Gdy podłączysz do komputera urządzenie z Androidem 4.2.2 (poziom interfejsu API 17) lub nowszym, system wyświetli okno z pytaniem, czy zaakceptować klucz RSA, który umożliwia debugowanie na tym komputerze. Ten mechanizm zabezpieczeń chroni urządzenia użytkowników, ponieważ debugowanie USB i inne polecenia adb nie mogą zostać wykonane, dopóki nie odblokujesz urządzenia i nie potwierdzisz okna.