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 Twój zegarek ma port USB, połącz przez 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 zegarka, możesz przetestować i uruchomić aplikację na emulatorze w Android Studio.

Zaktualizuj Wear OS do najnowszej wersji

Aby sprawdzić, czy aplikacja działa zgodnie z oczekiwaniami w najnowszym oprogramowaniu, Sprawdź, czy urządzenie testowe ma najnowszą wersję Wear OS obsługiwane przez Twoje urządzenie.

Aby sprawdzić dostępność aktualizacji systemu na urządzeniu testowym, wykonaj te czynności:

  1. Połącz urządzenie z siecią Wi-Fi.
  2. Zacznij ładować urządzenie.
  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 konkretną wersję Wear OS (opcjonalnie)

Jeśli przypadek testowy aplikacji zależy od konkretnej wersji Wear OS, możesz czyli flashować oprogramowanie na zegarkach obsługujących połączenie USB. Na przykład możesz wgrać obraz fabryczny lub pełny obraz OTA na urządzeniu Google Pixel Watch 3 lub Google Pixel Watch 2.

Włączanie opcji programisty na zegarku

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, wykonaj te czynności:

  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. Na zegarku otwórz Ustawienia.
  2. Kliknij Połączenia > Wi-Fi.
  3. Wybierz sieć i w razie potrzeby wpisz jej hasło.

    Uwaga: Zegarek i komputer używany do programowania muszą być połączone z tą samą siecią. Nie wszystkie odpowiednich punktów dostępu. Konieczne może być użycie punktu dostępu, którego zapora sieciowa jest prawidłowo skonfigurowana do obsługi adb.

Włącz debugowanie Wi-Fi

  1. Na zegarku otwórz Ustawienia.
  2. Kliknij Opcje programisty > Debugowanie przez Wi-Fi.
  3. Po chwili na ekranie pojawi się adres IP zegarka, np. 192.168.1.100. Będzie Ci ona potrzebna w następnym kroku, więc zapisz ją.

Parowanie debugera z zegarkiem

  1. Na urządzeniu z Wear OS znajdź opcje debugowania bezprzewodowego w ustawieniach systemu. Wybierz 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, podaj kod parowania Wi-Fi z kroku 2. Terminal wyświetli informację, czy udało się sparować. Na przykład: 
    Enter pairing code: 123456
Successfully paired to 192.168.1.100:5555
. Po sparowaniu komputer hosta pojawi się na liście Sparowanych urządzeń. na ekranie Debugowanie bezprzewodowe na urządzeniu z Wear OS.

Łączenie debugera z zegarkiem

  1. Połącz zegarek i komputer do programowania 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 to 192.168.1.100, a numer portu to 5555, polecenie adb connect i jego 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 z zegarkiem przy użyciu flagi -s, która określa jego adres IP 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 z Androidem połączonych 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 ustawienie programisty opcje 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. Otwórz menu Ustawienia zegarka.
  2. Przewiń do sekcji Opcje programisty.
  3. Sprawdź, czy jest włączone debugowanie ADB.
  4. Włącz 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ć opcji w Ustawieniach zaawansowanych.
  3. Włącz Debugowanie przez Bluetooth. Następujący komunikat o stanie jest widoczna pod opcją: 
    Host: disconnected
Target: connected

W tym momencie maszyna do tworzenia aplikacji (host) nie komunikuje się z zegarkiem (elementem docelowym). Musisz dokończyć tworzenie połączenia.

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

Na tym ostatnim etapie używasz wszystkich elementów: debugera, telefonu i zegarka.

  1. Podłącz telefon do komputera za pomocą kabla 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. Gdy wpiszesz polecenie połączenia, zegarek poprosi o potwierdzenie Debugowanie ADB.
  4. Na telefonie sprawdź wyświetlanie stanu w aplikacji towarzyszącej Wear OS: 
    Host: connected
Target: connected

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

Podczas debugowania zegarka za pomocą Bluetooth adb zawsze używa adresu IP 127.0.0.1 oraz przypisanego 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 zajmujesz się programowaniem na komputerze z systemem macOS, możesz użyć projektu na GitHubie narzędzia Android na Mac, aby nagrać film z urządzenia z Wear OS.

Możesz też nagrać film za pomocą urządzenia z Wear OS, wykonując te czynności:

  1. Rejestrowanie nieprzetworzonych klatek na zegarku: 
    adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw
  2. Skopiuj nieprzetworzony plik do komputera, z którego korzystasz: 
    adb pull /sdcard/video.raw video.raw
  3. Użyj aplikacji ffmpeg, aby przekonwertować plik nieskompresowany na format MP4: 
    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.