Debugowanie aplikacji na Wear OS

Aby debugować aplikację Wear OS na zegarku fizycznym, połącz z zegarkiem maszynę, której używasz do tworzenia aplikacji, za pomocą Wi-Fi lub Bluetooth. Jeśli Twój zegarek ma port USB, połącz przez USB.

Możesz też przetestować przepływy pracy dotyczące wielu urządzeń, takich jak zegarek telefonu, jeśli aplikacja jej wymaga. Aby dowiedzieć się więcej o konfigurowaniu połączenia do testowania, odwiedź stronę Połącz zegarek z telefonu.

Uwaga: jeśli nie masz fizycznego zegarka, możesz też przetestuj i uruchom przy użyciu emulatora 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. Rozpocznij ładowanie urządzenia.
  3. Poczekaj, aż poziom naładowania baterii urządzenia wyniesie 50% lub więcej.

  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. Dla: możesz na przykład użyć funkcji Flash obraz fabryczny lub pełny obraz OTA na zegarek Google Pixel Watch 2.

Włącz na zegarku opcje programisty

Aby przeprowadzić debugowanie na zegarku, włącz opcje programisty. Wystarczy to zrobić raz. Opcje programisty pozostaną włączone do możesz je wyłączyć. Aby włączyć opcje programisty, wykonaj te czynności:

  1. Na zegarku otwórz Ustawienia.
  2. Kliknij System > Informacje > Wersje.
  3. Kliknij 7 razy element Numer kompilacji.
  4. Pojawi się komunikat z potwierdzeniem, że jesteś teraz deweloperem.

Debuguj przez Wi-Fi

Zanim zaczniesz, włącz na zegarku opcje programisty w sposób opisany powyżej.

Połącz zegarek 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. Może być konieczne użycie punktu dostępu ze skonfigurowaną zaporą sieciową prawidłowo obsługuje adb.

Włącz debugowanie Wi-Fi

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

Sparuj debuger z zegarkiem

  1. Na urządzeniu z Wear OS znajdź opcje debugowania bezprzewodowego w systemie ustawieniach. Wybierz Sparuj nowe urządzenie.
  2. Zapisz kod parowania Wi-Fi oraz adres IP lub przenieść dane.
  3. W oknie terminala na komputerze, którego używasz do programowania, wpisz: polecenie: 
    adb pair IP_ADDRESS:PORT
  4. Gdy pojawi się prośba, podaj 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 Sparowanych urządzeń. na ekranie Debugowanie bezprzewodowe na urządzeniu z Wear OS.

Połącz debuger z zegarkiem

  1. Połącz zegarek i komputer do programowania z tą samą siecią.

  2. Połącz debuger z zegarkiem, używając jego adresu IP i portu numer. Jeśli na przykład adres IP to 192.168.1.100, a numer portu to 5555, Polecenie adb connect i jego odpowiedź wyglądają tak: 

    adb connect 192.168.1.100:5555
connected to 192.168.1.100:5555

Zegarek jest teraz połączony z debugerem. 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 podłączone tylko 1 urządzenie do debugowania, nie musisz należy podać adres:

adb <command>

Debuguj przez Bluetooth

Uwaga: debugowanie Bluetooth działa tylko w przypadku sparowanych urządzeń z Androidem zegarków z Wear OS 2.

Przed Tobą rozpocznij, sparuj zegarek z telefonem i włącz opcje programisty na zegarka w sposób opisany powyżej. Sprawdź, czy opcje programisty są włączone na otwórz aplikację telefonu, Ustawienia i poszukaj Opcji 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łącz debugowanie ADB lub Bluetooth na zegarku

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

Włącz debugowanie Bluetooth 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 programistyczna, czyli host, nie komunikuje się z zegarek – cel. Musisz dokończyć tworzenie połączenia.

Uwaga: możesz debugować tylko na 1 urządzeniu naraz. Jeśli masz sparowanych kilka zegarków, debugowanie Bluetooth będzie włączone tylko po wybraniu urządzenia na ekranie głównym.

Połącz debuger z zegarkiem

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

  1. Podłącz telefon do komputera kablem USB.
  2. Uruchom te 2 polecenia w debugerze: 
    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 w komputerze, na którym pracujesz, i używać tego samego portu w obu poleceniach. W tym przykładzie para klucz-wartość port to 4444.

  3. Gdy wpiszesz polecenie połączenia, zegarek poprosi o potwierdzenie Debugowanie ADB.
  4. Na telefonie sprawdź w wyświetlanym stanie w aplikacji towarzyszącej Wear OS: 
    Host: connected
Target: connected

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

Podczas debugowania zegarka przez Bluetooth adb zawsze używa adresu IP 127.0.0.1 oraz przypisany przez Ciebie port. W tym przykładzie port to 4444. Wszystkie polecenia adb używają makra w tym formacie:

adb -s 127.0.0.1:4444 <command>

Jeśli nie używasz emulatora i masz podłączone tylko 1 urządzenie do debugowania, nie musisz należy podać adres:

adb <command>

Używaj nagrywania ekranu na Wear OS

Jeśli tworzysz aplikacje w systemie macOS, możesz użyć projektu GitHub narzędzie na Androida na Macu – pozwala 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. Nagrywaj nieprzetworzone klatki 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 narzędzia ffmpeg, aby przekonwertować plik nieprzetworzony do formatu 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: Odwiedź stronę FFmpeg, aby ją pobrać i instrukcje instalacji.