Debugowanie aplikacji na Wear OS

Aby debugować aplikację na Wear OS na fizycznym zegarku, połącz urządzenie do tworzenia aplikacji z zegarkiem przez Wi-Fi lub Bluetooth. Jeśli zegarek ma port USB, połącz się za pomocą kabla USB.

Jeśli aplikacja wymaga takiej obsługi, możesz też testować przepływy pracy obejmujące kilka urządzeń, np. zegarek i telefon. Więcej informacji o konfigurowaniu połączenia na potrzeby testowania znajdziesz w artykule Łączenie zegarka z telefonem.

Uwaga: jeśli nie masz fizycznego zegarka, możesz też przetestować i uruchomić aplikację przy użyciu emulatora w Android Studio.

Zaktualizuj Wear OS do najnowszej wersji

Aby sprawdzić, czy aplikacja działa zgodnie z oczekiwaniami w najnowszej wersji oprogramowania, sprawdź, czy na urządzeniu testowym jest zainstalowana najnowsza wersja Wear OS, którą obsługuje to urządzenie.

Aby sprawdzić dostępność aktualizacji systemu na urządzeniu testowym:

  1. Połącz urządzenie z siecią Wi-Fi.
  2. Rozpocznij ładowanie urządzenia.
  3. Poczekaj, aż bateria urządzenia naładuje się do poziomu co najmniej 50%.

  4. Na urządzeniu testowym otwórz Ustawienia > System > Aktualizacje systemu.

    Jeśli aktualizacja systemu jest dostępna, zostanie pobrana i zainstalowana na urządzeniu testowym.

Zainstaluj określoną wersję Wear OS (opcjonalnie)

Jeśli przypadek testowy aplikacji zależy od konkretnej wersji Wear OS, możesz wgrać obraz oprogramowania na zegarkach, które obsługują połączenie danych przez USB. Możesz na przykład wgrać obraz fabryczny lub pełny obraz OTA do urządzenia Google Pixel Watch 3 lub Google Pixel Watch 2.

Włącz na zegarku opcje programisty

Zanim zaczniesz debugować na zegarku, włącz opcje dla programistów. Wystarczy to zrobić tylko raz. Opcje programisty pozostają włączone, dopóki ich nie wyłączysz. Aby włączyć opcje programisty:

  1. Otwórz Ustawienia na zegarku.
  2. Kliknij System > Informacje > Wersje.
  3. Siedem razy kliknij element Numer kompilacji.
  4. Pojawi się komunikat potwierdzający, że jesteś teraz programistą.

Debuguj przez Wi-Fi

Zanim zaczniesz, włącz opcje programisty na zegarku w sposób opisany wcześniej.

Łączenie zegarka z siecią Wi-Fi

  1. Otwórz Ustawienia na zegarku.
  2. Kliknij Połączenia > Wi-Fi.
  3. Wybierz sieć i w razie potrzeby wpisz jej hasło.

    Uwaga:zegarek i urządzenie programistyczne muszą być połączone z tą samą siecią. Nie wszystkie punkty dostępu są odpowiednie. Konieczne może być użycie punktu dostępu, którego zapora sieciowa jest prawidłowo skonfigurowana do obsługi adb.

Włączanie debugowania Wi-Fi

  1. Otwórz Ustawienia na zegarku.
  2. Kliknij Opcje programisty > Debugowanie przez Wi-Fi.
  3. Po chwili na ekranie pojawi się adres IP zegarka, np. 192.168.1.100. Będziesz go potrzebować w następnym kroku, więc zanotuj go.

Parowanie debugera z zegarkiem

  1. Na urządzeniu z Wear OS znajdź opcje debugowania bezprzewodowego w ustawieniach systemu. Kliknij Sparuj nowe urządzenie.
  2. Zapisz kod parowania Wi-Fi oraz adres IP i port.
  3. W oknie terminala na komputerze deweloperskim wpisz to polecenie: 
    adb pair IP_ADDRESS:PORT
  4. Gdy pojawi się prośba, wpisz kod parowania Wi-Fi z kroku 2. Terminal poinformuje, czy udało się sparować. Przykład:
    Enter pairing code: 123456
Successfully paired to 192.168.1.100:5555
Po sparowaniu komputer hosta pojawi się na liście Sparowane urządzenia na ekranie Debugowanie bezprzewodowe urządzenia Wear OS.

Łączenie debugera z zegarkiem

  1. Połącz zegarek i urządzenie do tworzenia aplikacji z tą samą siecią.

  2. Połącz debuger z zegarkiem, używając adresu IP zegarka i numeru portu. Jeśli na przykład adres IP to192.168.1.100, a numer portu to5555, polecenieadb connect i odpowiednia odpowiedź będą wyglądać tak:

    adb connect 192.168.1.100:5555
connected to 192.168.1.100:5555

Zegarek jest teraz połączony z debugerem i możesz rozpocząć debugowanie. Wyślij polecenia adb do zegarka, używając flagi -s, podając adres IP i numer portu:

adb -s 192.168.1.100:5555 <command>

Jeśli nie używasz emulatora i masz tylko jedno urządzenie podłączone do debugowania, nie musisz podawać adresu:

adb <command>

Debuguj przez Bluetooth

Uwaga: debugowanie Bluetooth działa tylko na zegarkach sparowanych z Androidem z Wear OS 2.

Zanim zaczniesz, sparuj zegarek z telefonem i włącz na zegarku opcje dla programistów w sposób opisany wcześniej. Sprawdź, czy na telefonie są włączone opcje programisty. W tym celu otwórz menu Ustawienia i poszukaj opcji Opcje programisty. W razie potrzeby włącz opcje programisty na telefonie.

Włącz debugowanie USB w telefonie

  1. Otwórz na telefonie menu Ustawienia.
  2. Wybierz Opcje programisty i włącz Debugowanie USB.

Włączanie debugowania ADB lub Bluetootha na zegarku

  1. Na zegarku otwórz menu Ustawienia.
  2. Przewiń do sekcji Opcje programisty.
  3. Sprawdź, czy debugowanie ADB jest włączone.
  4. Włącz opcję Debugowanie przez Bluetooth.

Włączanie debugowania Bluetootha na telefonie

  1. Na telefonie otwórz aplikację towarzyszącą Wear OS.
  2. Przewiń do sekcji Ustawienia zaawansowane i kliknij, aby wyświetlić opcje Ustawień zaawansowanych.
  3. Włącz Debugowanie przez Bluetooth. Pod opcją wyświetla się komunikat o stanie: 
    Host: disconnected
Target: connected

W tym momencie maszyna do tworzenia aplikacji (host) nie komunikuje się z zegarkiem (elementem docelowym). Musisz utworzyć połączenie.

Uwaga: możesz debugować tylko 1 urządzenie naraz. Jeśli masz sparowane kilka zegarków, debugowanie Bluetooth jest włączone tylko w przypadku urządzenia wybranego na ekranie głównym.

Łączenie debugera z zegarkiem

W tym ostatnim kroku użyjesz wszystkiego: debugera, telefonu i zegarka.

  1. Podłącz telefon do komputera kablem USB.
  2. Uruchom w debugerze te 2 polecenia: 
    adb forward tcp:4444 localabstract:/adb-hub
adb connect 127.0.0.1:4444

    Uwaga: musisz użyć adresu IP 127.0.0.1. Użyj dowolnego dostępnego portu na komputerze programistycznym i użyj tego samego portu w obu poleceniach. W tym przykładzie port to 4444.

  3. Po wpisaniu polecenia łączenia zegarek poprosi o potwierdzenie, że zezwalasz na debugowanie ADB.
  4. Na telefonie sprawdź w wyświetlanym stanie w aplikacji towarzyszącej Wear OS te elementy: 
    Host: connected
Target: connected

    5. Zegarek jest teraz połączony z debugerem i możesz rozpocząć debugowanie.

Podczas debugowania zegarka przez Bluetooth adb zawsze używa adresu IP 127.0.0.1 oraz przypisanego przez Ciebie portu. W tym przykładzie port to 4444. Wszystkie polecenia adb mają następujący format:

adb -s 127.0.0.1:4444 <command>

Jeśli nie używasz emulatora i masz tylko jedno urządzenie podłączone do debugowania, nie musisz podawać adresu:

adb <command>

Używaj nagrywania ekranu na Wear OS

Jeśli programujesz w systemie macOS, możesz nagrać film z urządzenia z Wear OS za pomocą projektu GitHub narzędzia Android dla Maca.

Możesz też nagrać film na urządzeniu z Wear OS w ten sposób:

  1. Rejestrowanie nieprzetworzonych klatek na zegarku:
    adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw
  2. Skopiuj plik nieprzetworzony na komputer programisty: 
    adb pull /sdcard/video.raw video.raw
  3. Aby przekonwertować plik źródłowy na MP4, użyj ffmpeg: 
    ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

    Uwaga: instrukcje pobierania i instalowania znajdziesz na stronie FFmpeg.