Diese Seite wurde von der Cloud Translation API übersetzt.

Wear OS-Apps debuggen

Wenn Sie Fehler in der Wear OS-App auf einer physischen Smartwatch beheben möchten, verbinden Sie Ihr Entwicklungsgerät über WLAN oder Bluetooth mit der Smartwatch. Wenn deine Uhr einen USB-Port hat, kannst du sie über USB verbinden.

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

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

Auf die neueste Version von Wear OS aktualisieren

Damit deine App mit der neuesten Software wie erwartet funktioniert, solltest du prüfen, ob auf deinem Testgerät die neueste Version von Wear OS ausgeführt wird, die von deinem Gerät unterstützt wird.

So suchen Sie auf Ihrem Testgerät nach einem Systemupdate:

Verbinden Sie das Gerät mit einem WLAN.
Beginnen Sie mit dem Aufladen.
Warten Sie, bis der Akku des Geräts zu mindestens 50% geladen ist.
Rufe auf deinem Testgerät Einstellungen > System > Systemupdates auf.

Ist ein Systemupdate verfügbar, wird es heruntergeladen und auf dem Testgerät installiert.

Bestimmte Wear OS-Version installieren (optional)

Wenn der Testlauf deiner App von einer bestimmten Version von Wear OS abhängt, kannst du ein Softwarebild auf Smartwatches flashen, die eine USB-Datenverbindung unterstützen. Du kannst beispielsweise ein Factory-Image oder ein vollständiges OTA-Image auf Google Pixel Watch 2 flashen.

Entwickleroptionen auf deiner Smartwatch aktivieren

Bevor du auf deiner Smartwatch Fehler beheben kannst, musst du die Entwickleroptionen aktivieren. Dies ist nur einmal erforderlich. Entwickleroptionen bleiben aktiviert, bis Sie sie deaktivieren. So aktivieren Sie Entwickleroptionen:

Öffnen Sie die Einstellungen der Smartwatch.
Tippe auf System > Info > Versionen.
Tippen Sie siebenmal auf die Build-Nummer.
Es wird eine Meldung angezeigt, in der bestätigt wird, dass Sie jetzt Entwickler sind.

Fehler über WLAN beheben

Bevor du beginnst, aktiviere wie zuvor beschrieben die Entwickleroptionen auf der Smartwatch.

Verbinde die Uhr mit einem WLAN-Netzwerk.

Öffnen Sie die Einstellungen der Smartwatch.
Tippen Sie auf Konnektivität > WLAN.
Wählen Sie ein Netzwerk aus und geben Sie bei Bedarf das Passwort ein.
Hinweis: Die Uhr und dein Entwicklungscomputer müssen mit demselben Netzwerk verbunden sein. Nicht alle Zugangspunkte sind geeignet. Möglicherweise musst du einen Zugangspunkt verwenden, dessen Firewall so konfiguriert ist, dass adb unterstützt wird.

WLAN-Debugging aktivieren

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

Debugger mit der Uhr koppeln

Auf deinem Wear OS-Gerät findest du in den Systemeinstellungen die Optionen zur Fehlerbehebung bei kabellosem Laden. Wählen Sie Neues Gerät koppeln aus.
Notieren Sie sich den WLAN-Kopplungscode und die IP-Adresse und den Port.
Geben Sie in einem Terminalfenster auf Ihrem Entwicklungscomputer den folgenden Befehl ein:
```
adb pair IP_ADDRESS:PORT
```
Wenn du dazu aufgefordert wirst, gib den WLAN-Kopplungscode aus Schritt 2 ein. Das Terminal zeigt 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 WLAN-Debugging Ihres Wear OS-Geräts angezeigt.

Debugger mit der Smartwatch verbinden

Verbinden Sie Ihre Uhr und Ihren Entwicklungscomputer mit demselben Netzwerk.
Verbinden Sie den Debugger über die IP-Adresse der Uhr und eine Portnummer mit der Uhr. Wenn die IP-Adresse beispielsweise 192.168.1.100 und die Portnummer 5555 lautet, sehen der adb connect-Befehl und die zugehörige Antwort so aus:
```
adb connect 192.168.1.100:5555
connected to 192.168.1.100:5555
```

Die Uhr ist jetzt mit dem Debugger verbunden und du kannst mit dem Debugging beginnen. Senden Sie adb-Befehle an die Smartwatch mit dem Flag -s. Geben Sie dabei die IP-Adresse der Smartwatch und die Portnummer an:

adb -s 192.168.1.100:5555 <command>

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

adb <command>

Debugging über Bluetooth

Hinweis: Das Bluetooth-Debugging funktioniert nur bei mit Android gekoppelten Smartwatches mit Wear OS 2.

Bevor du beginnst, koppele die Smartwatch mit dem Smartphone und aktiviere wie oben beschrieben die Entwickleroptionen auf der Smartwatch. Prüfen Sie, ob die Entwickleroptionen auf dem Smartphone aktiviert sind. Öffnen Sie dazu das Menü Einstellungen und suchen Sie nach Entwickleroptionen. Falls nötig, aktivieren Sie die Entwickleroptionen auf dem Smartphone.

USB-Debugging auf dem Smartphone aktivieren

Öffnen Sie auf dem Smartphone das Menü Einstellungen.
Wähle Entwickleroptionen aus und aktiviere USB-Debugging.

ADB- oder Bluetooth-Debugging auf der Smartwatch aktivieren

Öffnen Sie auf der Smartwatch das Menü Einstellungen.
Scrollen Sie zu Entwickleroptionen.
Prüfen Sie, ob ADB-Debugging aktiviert ist.
Aktivieren Sie die Option Fehlerbehebung über Bluetooth.

Bluetooth-Debugging auf dem Smartphone aktivieren

Öffnen Sie auf dem Smartphone die Wear OS Companion App.
Scrolle zu Erweiterte Einstellungen und tippe auf Erweiterte Einstellungen.
Aktivieren Sie Debugging über Bluetooth. Die folgende Statusmeldung wird unter der Option angezeigt:
```
Host: disconnected
Target: connected
```

An diesem Punkt kommuniziert der Entwicklungsmaschine – der Host – nicht mit der Uhr – dem Ziel. Sie müssen die Verknüpfung fertigstellen.

Hinweis: Sie können Fehler nur mit jeweils einem Gerät beheben. Wenn du mehrere Uhren gekoppelt hast, ist Bluetooth-Debugging nur mit dem 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.

Verbinden Sie das Smartphone über ein USB-Kabel mit dem Entwicklungscomputer.
Führen Sie diese beiden Befehle im Debugger 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 denselben Port in beiden Befehlen. In diesem Beispiel ist der Port 4444.
Nachdem Sie den Befehl zum Verbinden eingegeben haben, werden Sie von der Smartwatch aufgefordert, zu bestätigen, dass Sie die ADB-Fehlerbehebung zulassen.
Prüfen Sie auf dem Smartphone in der Companion-App von Wear OS, ob auf der Statusanzeige Folgendes angezeigt wird:
```
Host: connected
Target: connected
```

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

Wenn du eine Smartwatch mit Bluetooth behebst, verwendet adb immer die IP-Adresse 127.0.0.1 plus den von dir zugewiesenen Port. In diesem Beispiel ist 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 Debugging verbunden haben, müssen Sie die Adresse nicht angeben:

adb <command>

Bildschirmaufzeichnung für Wear OS verwenden

Wenn du unter macOS entwickelst, kannst du mit dem GitHub-Projekt Android-Tool für Mac ein Video mit deinem Wear OS-Gerät aufzeichnen.

Alternativ können Sie so ein Video mit Ihrem Wear OS-Gerät aufzeichnen:

Nimm unbearbeitete Frames auf der Smartwatch auf:

adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw

Kopieren Sie die RAW-Datei auf Ihren Entwicklungscomputer:
```
adb pull /sdcard/video.raw video.raw
```
Verwenden Sie ffmpeg, um die RAW-Datei in MP4 zu konvertieren:
```
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 in den folgenden Ressourcen: