Wear OS-Apps debuggen

Wenn Sie Ihre Wear OS-App auf einer Smartwatch debuggen möchten, verbinden Sie Ihren Entwicklungscomputer über WLAN oder Bluetooth mit der Smartwatch. Wenn Ihre Smartwatch einen USB-Anschluss hat, können Sie sie auch über USB verbinden.

Du kannst auch Workflows testen, die sich über mehrere Geräte wie eine Smartwatch und ein Smartphone erstrecken, wenn diese Unterstützung für deine App erforderlich ist. Weitere Informationen zum Einrichten einer Verbindung für Tests finden Sie unter Smartwatch mit einem Smartphone verbinden.

Hinweis : Wenn du keine physische Uhr hast, kannst du deine App auch in Android Studio testen und in einem Emulator ausführen.

Auf die neueste Version von Wear OS aktualisieren

Prüfen Sie, ob auf Ihrem Testgerät die neueste Version von Wear OS ausgeführt wird, die Ihr Gerät unterstützt, um sicherzustellen, dass sich Ihre App wie erwartet verhält.

So prüfen Sie auf Ihrem Testgerät, ob ein Systemupdate verfügbar ist:

  1. Verbinden Sie das Gerät mit einem WLAN.
  2. Lade das Gerät auf.
  3. Warten Sie, bis der Akku des Geräts mindestens 50% geladen ist.

  4. Gehen Sie auf Ihrem Testgerät zu Einstellungen > System > Systemupdates.

    Wenn ein Systemupdate verfügbar ist, wird es auf Ihr Testgerät heruntergeladen und installiert.

Bestimmte Version von Wear OS installieren (optional)

Wenn der Testfall Ihrer App von einer bestimmten Version von Wear OS abhängt, können Sie ein Software-Image auf Smartwatches flashen, die eine USB-Datenverbindung unterstützen. Sie können beispielsweise ein Werks-Image oder ein vollständiges OTA-Image auf eine Google Pixel Watch 3 oder Google Pixel Watch 2 flashen.

Entwickleroptionen auf Ihrer Smartwatch aktivieren

Bevor Sie auf Ihrer Smartwatch Fehler beheben können, müssen Sie die Entwickleroptionen aktivieren. Sie müssen dies nur einmal tun. Die Entwickleroptionen bleiben aktiviert, bis Sie sie deaktivieren. So aktivieren Sie die Entwickleroptionen:

  1. Öffnen Sie auf der Smartwatch die Einstellungen.
  2. Tippen Sie auf System > Info > Versionen.
  3. Tippen Sie siebenmal auf die Build-Nummer.
  4. Es wird eine Bestätigung angezeigt, dass Sie jetzt Entwickler sind.

Fehler über WLAN beheben

Aktivieren Sie zuerst die Entwickleroptionen auf der Smartwatch, wie oben beschrieben.

Smartwatch mit einem WLAN verbinden

  1. Öffnen Sie auf der Smartwatch die Einstellungen.
  2. Tippen Sie auf Verbindung > WLAN.
  3. Wählen Sie ein Netzwerk aus und geben Sie ggf. das Passwort für das Netzwerk ein.

    Hinweis:Die Smartwatch und Ihr Entwicklungscomputer müssen mit demselben Netzwerk verbunden sein. Nicht alle Zugangspunkte sind geeignet. Möglicherweise müssen Sie einen Zugangspunkt verwenden, dessen Firewall ordnungsgemäß für die Unterstützung von adb konfiguriert ist.

WLAN-Fehlerbehebung aktivieren

  1. Öffnen Sie die Einstellungen der Smartwatch.
  2. Tippen Sie auf Entwickleroptionen > Fehler über WLAN beheben.
  3. Nach kurzer Zeit wird auf dem Display die IP-Adresse der Smartwatch angezeigt, z. B. 192.168.1.100. Notieren Sie sich diese Nummer, da Sie sie für den nächsten Schritt benötigen.

Debugger mit der Smartwatch koppeln

  1. Suchen Sie auf Ihrem Wear OS-Gerät in den Systemeinstellungen nach den Optionen für die drahtlose Fehlerbehebung. Wählen Sie Neues Gerät koppeln aus.
  2. Notieren Sie sich den WLAN-Kopplungscode und die IP-Adresse und den Port.
  3. Geben Sie in einem Terminalfenster auf Ihrem Entwicklungscomputer den folgenden Befehl ein: 
    adb pair IP_ADDRESS:PORT
  4. Gib den WLAN-Kopplungscode aus Schritt 2 ein, wenn du dazu aufgefordert wirst. Das Terminal gibt an, ob die Kopplung erfolgreich war. Beispiel: 
    Enter pairing code: 123456
Successfully paired to 192.168.1.100:5555
Nach der Kopplung wird der Hostcomputer in der Liste der gekoppelten Geräte auf dem Bildschirm Drahtloses Debugging Ihres Wear OS-Geräts angezeigt.

Debugger mit der Smartwatch verbinden

  1. Verbinden Sie Ihre Smartwatch und Ihren Entwicklungscomputer mit demselben Netzwerk.

  2. Stellen Sie eine Verbindung zwischen dem Debugger und der Smartwatch über die IP-Adresse und eine Portnummer der Smartwatch her. Wenn die IP-Adresse beispielsweise 192.168.1.100 und die Portnummer 5555 lautet, sehen der adb connect-Befehl und die Antwort so aus: 

    adb connect 192.168.1.100:5555
connected to 192.168.1.100:5555

Die Smartwatch ist jetzt mit dem Debugger verbunden und Sie können mit der Fehlerbehebung beginnen. Senden Sie adb-Befehle mit dem Flag -s an die Smartwatch und geben Sie dabei die IP-Adresse und die Portnummer der Smartwatch an:

adb -s 192.168.1.100:5555 <command>

Wenn Sie den Emulator nicht verwenden und nur ein Gerät zum Debuggen verbunden ist, müssen Sie die Adresse nicht angeben:

adb <command>

Debugging über Bluetooth

Hinweis: Das Bluetooth-Debugging funktioniert nur für mit Android gekoppelte Smartwatches mit Wear OS 2.

Koppeln Sie zuerst die Smartwatch und das Smartphone und aktivieren Sie wie zuvor beschrieben die Entwickleroptionen auf der Smartwatch. Prüfen Sie, ob die Entwickleroptionen auf dem Smartphone aktiviert sind. Öffnen Sie dazu die Einstellungen und suchen Sie nach Entwickleroptionen. Aktiviere die Entwickleroptionen auf dem Smartphone, falls erforderlich.

USB-Debugging auf dem Smartphone aktivieren

  1. Öffnen Sie auf dem Smartphone das Menü Einstellungen.
  2. Wählen Sie Entwickleroptionen aus und aktivieren Sie USB-Debugging.

ADB- oder Bluetooth-Fehlerbehebung auf der Smartwatch aktivieren

  1. Öffnen Sie auf der Smartwatch das Menü Einstellungen.
  2. Scrollen Sie zu Entwickleroptionen.
  3. Prüfen Sie, ob die ADB-Fehlerbehebung aktiviert ist.
  4. Aktivieren Sie Über Bluetooth debuggen.

Bluetooth-Debugging auf dem Smartphone aktivieren

  1. Öffnen Sie auf dem Smartphone die Wear OS Companion App.
  2. Scrollen Sie zu Erweiterte Einstellungen und tippen Sie darauf, um die Optionen für die Erweiterten Einstellungen aufzurufen.
  3. Aktivieren Sie Debugging über Bluetooth. Unter der Option wird die folgende Statusmeldung angezeigt: 
    Host: disconnected
Target: connected

Zu diesem Zeitpunkt kommuniziert der Entwicklungscomputer (der Host) nicht mit der Smartwatch (dem Ziel). Sie müssen die Verknüpfung herstellen.

Hinweis: Sie können jeweils nur ein Gerät debuggen. Wenn Sie mehrere Smartwatches gekoppelt haben, ist die Bluetooth-Fehlerbehebung nur für das Gerät aktiviert, das auf dem Hauptbildschirm ausgewählt ist.

Debugger mit der Smartwatch verbinden

In diesem letzten Schritt verwenden Sie alles: den Debugger, das Smartphone und die Smartwatch.

  1. Verbinden Sie das Smartphone über ein USB-Kabel mit dem Entwicklungscomputer.
  2. Führen Sie im Debugger die folgenden beiden Befehle aus: 
    adb forward tcp:4444 localabstract:/adb-hub
adb connect 127.0.0.1:4444

    Hinweis: Sie müssen die IP-Adresse 127.0.0.1 verwenden. Verwenden Sie einen beliebigen verfügbaren Port auf Ihrem Entwicklungscomputer und verwenden Sie in beiden Befehlen denselben Port. In diesem Beispiel ist der Port 4444.

  3. Nachdem Sie den Befehl zum Verbinden eingegeben haben, werden Sie auf der Smartwatch aufgefordert, zu bestätigen, dass Sie das ADB-Debugging zulassen.
  4. Prüfen Sie auf dem Smartphone in der Wear OS Companion App den Status: 
    Host: connected
Target: connected

    5. Die Smartwatch ist jetzt mit dem Debugger verbunden und Sie können mit der Fehlerbehebung beginnen.

Wenn Sie eine Smartwatch über Bluetooth debuggen, verwendet adb immer die IP-Adresse 127.0.0.1 und den von Ihnen zugewiesenen Port. In diesem Beispiel lautet der Port 4444. Alle adb-Befehle haben das folgende Format:

adb -s 127.0.0.1:4444 <command>

Wenn Sie den Emulator nicht verwenden und nur ein Gerät zum Debuggen verbunden ist, müssen Sie die Adresse nicht angeben:

adb <command>

Bildschirmaufzeichnung für Wear OS verwenden

Wenn Sie unter macOS entwickeln, können Sie mit dem GitHub-Projekt Android Tool for Mac ein Video von Ihrem Wear OS-Gerät aufnehmen.

Alternativ kannst du mit den folgenden Schritten ein Video über dein Wear OS-Gerät aufnehmen:

  1. RAW-Frames auf der Smartwatch aufzeichnen: 
    adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw
  2. Kopieren Sie die Rohdatei auf Ihren Entwicklungscomputer: 
    adb pull /sdcard/video.raw video.raw
  3. Verwende ffmpeg, um die Rohdatei in MP4 umzuwandeln: 
    ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

    Hinweis:Download- und Installationsanleitungen finden Sie auf der FFmpeg-Website.

Weitere Informationen finden Sie unter den folgenden Links: