Zdalne debugowanie urządzeń z Androidem

Kayce Basques

Sofia Emelianova

Zdalnie debuguj treści na żywo na urządzeniu z Androidem na komputerze z systemem Windows, macOS lub Linux. Z tego samouczka dowiesz się, jak:

• Skonfiguruj swoje urządzenie z Androidem do zdalnego debugowania i wykrywaj je na komputerze, na którym pracujesz.
• Sprawdź i debuguj treści opublikowane na urządzeniu z Androidem, korzystając z komputera, którego używasz do programowania.
• Screencast treści z urządzenia z Androidem do instancji Narzędzi deweloperskich na komputerze programistycznym.

Krok 1. Odkryj swoje urządzenie z Androidem

Poniższy przepływ pracy sprawdza się w przypadku większości użytkowników. Więcej informacji znajdziesz w artykule Rozwiązywanie problemów: Narzędzia deweloperskie nie wykrywają urządzenia z Androidem.

1. Otwórz ekran Opcje programisty na urządzeniu z Androidem. Zobacz Konfigurowanie opcji programisty na urządzeniu.
2. Wybierz Włącz debugowanie USB.
3. Otwórz Chrome na komputerze, na którym tworzysz aplikacje.
4. Jedź do: chrome://inspect#devices.

5. Upewnij się, że opcja Wykrywanie urządzeń USB jest włączona.

   

6. Podłącz urządzenie z Androidem bezpośrednio do komputera programistycznego za pomocą kabla USB.

7. Jeśli łączysz urządzenie po raz pierwszy, wyświetli się ono jako „Offline” i oczekuje na uwierzytelnienie.

   

   W takim przypadku zaakceptuj prośbę o sesję debugowania na ekranie urządzenia.

8. Jeśli zobaczysz nazwę modelu urządzenia z Androidem, oznacza to, że Narzędzia deweloperskie nawiązały połączenie z urządzeniem.

   

9. Przejdź do kroku 2.

Rozwiązywanie problemów: Narzędzia deweloperskie nie wykrywają urządzenia z Androidem

Sprawdź, czy sprzęt jest prawidłowo skonfigurowany:

• Jeśli korzystasz z hubu USB, spróbuj podłączyć urządzenie z Androidem bezpośrednio do komputera, z którego korzystasz.
• Odłącz kabel USB między urządzeniem z Androidem a maszyną do programowania, a następnie podłącz go z powrotem. Zrób to, gdy ekrany Androida i urządzenia programistycznego są odblokowane.
• Sprawdź, czy kabel USB działa. Pliki na urządzeniu z Androidem możesz sprawdzać z poziomu komputera, z którego korzystasz.

Sprawdź, czy oprogramowanie jest prawidłowo skonfigurowane:

• Jeśli używasz komputera z systemem Windows, spróbuj ręcznie zainstalować sterowniki USB do urządzenia z Androidem. Patrz Instalowanie sterowników USB OEM.
• Niektóre kombinacje urządzeń z systemem Windows i Androida (w szczególności Samsunga) wymagają dodatkowej konfiguracji. Zapoznaj się z sekcją Urządzenia deweloperskie w Chrome nie wykrywają urządzenia po podłączeniu.

Jeśli na urządzeniu z Androidem nie widzisz komunikatu Zezwól na debugowanie USB:

• Odłączenie i ponowne podłączenie kabla USB, gdy Narzędzia deweloperskie skupiają się na maszynie programistycznej, a pojawia się ekran główny Androida. Inaczej mówiąc, czasami prompt nie pojawia się, gdy ekrany Androida lub komputera są zablokowane.
• Aktualizowanie ustawień wyświetlania urządzenia z Androidem i komputera programistycznego, aby nigdy nie uśpione.
• Ustawiam tryb USB na Androidzie na PTP. Zapoznaj się z artykułem Galaxy S4 nie wyświetla okna Autoryzuj debugowanie USB.
• Na ekranie Opcje programisty na urządzeniu z Androidem wybierz Unieważnij autoryzacje debugowania USB, aby przywrócić go do nowego stanu.

Jeśli znajdziesz rozwiązanie, którego nie ma w tej sekcji ani w artykule Urządzenia deweloperskie w Chrome nie wykrywają urządzenia po podłączeniu, podaj odpowiedź na pytanie w Stack Overflow lub otwórz problem w repozytorium developer.chrome.com.

Krok 2. Debuguj treści na urządzeniu z Androidem na komputerze, z którego korzystasz

1. Otwórz Chrome na urządzeniu z Androidem.

2. W narzędziu chrome://inspect/#devices na komputerze, którego używasz do programowania, zobaczysz nazwę modelu urządzenia z Androidem oraz numer seryjny. Poniżej widoczna jest wersja Chrome, która działa na urządzeniu. Numer wersji jest podany w nawiasach.

   

3. W polu tekstowym Otwórz kartę z adresem URL wpisz adres URL, a następnie kliknij Otwórz. Strona otworzy się w nowej karcie na urządzeniu z Androidem.

   

   Każda zdalna karta Chrome ma własną sekcję w chrome://inspect/#devices. W tej sekcji możesz wchodzić w interakcje z tą kartą. Jeśli istnieją aplikacje korzystające z WebView, zobaczysz sekcję dla każdej z nich. W tym przykładzie otwarta jest tylko jedna karta.

4. Obok otwartego adresu URL kliknij Zbadaj. Otworzy się nowa instancja Narzędzi deweloperskich.

Wersja Chrome działająca na urządzeniu z Androidem określa wersję Narzędzi deweloperskich otwieranych na komputerze, na którym pracujesz. Jeśli więc na urządzeniu z Androidem masz bardzo starą wersję Chrome, instancja Narzędzi deweloperskich może wyglądać zupełnie inaczej niż dawniej.

Więcej czynności: wstrzymywanie, zaznaczanie, ponowne załadowanie lub zamykanie karty

Pod adresem URL znajduje się menu umożliwiające wstrzymanie, zaznaczenie, ponowne załadowanie lub zamknięcie karty.

Sprawdź elementy

Otwórz panel Elementy instancji Narzędzi deweloperskich i najedź kursorem na element, aby go podświetlić w obszarze widocznym na urządzeniu z Androidem.

Możesz też kliknąć element na ekranie urządzenia z Androidem, by wybrać go w panelu Elementy. Kliknij Select Element w instancji Narzędzi deweloperskich, a następnie kliknij element na ekranie urządzenia z Androidem. Pamiętaj, że opcja Wybierz element jest wyłączona przy pierwszym kliknięciu, więc musisz włączyć ją ponownie za każdym razem, gdy chcesz jej użyć.

Przesyłanie ekranu z Androida na komputer używany do programowania

Kliknij Toggle Screencast , aby wyświetlić zawartość urządzenia z Androidem w instancji Narzędzi deweloperskich.

Możesz wchodzić w interakcje ze screencastem na kilka sposobów:

• Kliknięcia są przekształcane w kliknięcia, wywołujące odpowiednie zdarzenia dotykowe na urządzeniu.
• Naciśnięcia klawiszy w komputerze są wysyłane do urządzenia.
• Aby symulować gest ściągnięcia, przytrzymaj Shift podczas przeciągania.
• Aby przewijać, używaj trackpada lub kółka myszy albo przesuwaj palcem, używając wskaźnika myszy.

Uwagi na temat screencastów:

• Screencasty wyświetlają tylko zawartość strony. Przezroczyste części screencastu reprezentują interfejsy urządzenia, takie jak pasek adresu Chrome, pasek stanu Androida czy klawiatura Androida.
• Screencasty mają negatywny wpływ na liczbę klatek. Wyłącz przesyłanie ekranu podczas pomiaru przewijania lub animacji, aby uzyskać dokładniejszy obraz wydajności strony.
• Jeśli ekran urządzenia z Androidem zostanie zablokowany, zawartość screencasta zniknie. Odblokuj ekran urządzenia z Androidem, aby automatycznie wznowić screencast.

Debuguj ręcznie za pomocą narzędzia Android Debug Bridge (adb)

W rzadkich przypadkach może być przydatna alternatywna metoda zdalnego debugowania. Możesz na przykład połączyć się bezpośrednio z protokołem Narzędzi deweloperskich w Chrome (CDP) Chrome na Androida.

Aby to zrobić, możesz użyć narzędzia Android Debug Bridge (adb):

1. Pamiętaj, aby na urządzeniu z Androidem włączyć Opcje programisty i Debugowanie USB.
2. Otwórz Chrome na urządzeniu z Androidem.

3. Połącz urządzenie z Androidem z komputerem, którego używasz do programowania:

   • Kabel USB (prosty).
   • Możesz też wybrać połączenie Wi-Fi adb.

4. W wierszu poleceń komputera, którego używasz do programowania, uruchom adb devices -l i sprawdź, czy Twoje urządzenie znajduje się na liście.

5. Skieruj gniazdo CDP urządzenia do lokalnego portu komputera, na przykład 9222. Aby to zrobić, wpisz:

   adb forward tcp:9222 localabstract:chrome_devtools_remote
   

6. Sprawdź, czy po nawiązaniu połączenia:

   • http://localhost:9222/json zawiera listę wartości docelowych (page).
   • http://localhost:9222/json/version udostępnia docelowy punkt końcowy browser, zgodnie z dokumentacją CDP.
   • Pole chrome://inspect/#devices jest wypełnione, nawet jeśli ustawienie Wykrywanie urządzeń USB jest zaznaczone.

Informacje o rozwiązywaniu problemów:

• Dokumentacja adb

• Opcjonalnie możesz też przeczytać starsze przewodniki:

  • remote-debugging-legacy
  • zdalne debugowanie
  • girish.pl/...jak