Diese Seite wurde von der Cloud Translation API übersetzt.

Wear OS-Apps debuggen

Wenn du Fehler in deiner Wear OS-App auf einer physischen Smartwatch beheben möchtest, verbinde deinen Entwicklungscomputer über WLAN oder Bluetooth Falls Ihre Smartwatch einen USB-Port hat, stellen Sie eine USB-Verbindung her.

Du kannst auch Workflows testen, die mehrere Geräte umfassen, z. B. eine Smartwatch und ein wenn deine App diese Unterstützung benötigt. Weitere Informationen zum Einrichten einer Verbindung für Tests finden Sie unter Smartwatch mit einem Smartphone verbinden.

Hinweis: Wenn Sie keine Smartwatch haben, können Sie Ihre App auch in Android Studio testen und in einem Emulator ausführen.

Auf die neueste Version von Wear OS aktualisieren

Um zu prüfen, ob sich Ihre App in der aktuellen Software wie erwartet verhält, Prüfe, ob auf deinem Testgerät die neueste Version von Wear OS ausgeführt wird die Ihr Gerät unterstützt.

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

Verbinden Sie das Gerät mit einem WLAN.
Laden Sie das Gerät auf.
Warten Sie, bis der Akku des Geräts zu mindestens 50% aufgeladen ist.
Gehen Sie auf Ihrem Testgerät zu Einstellungen > System > Systemupdates.

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

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 deiner Smartwatch aktivieren

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

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

Fehler über WLAN beheben

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

Verbinde die Uhr mit einem WLAN-Netzwerk

Öffnen Sie auf der Smartwatch die Einstellungen.
Tippen Sie auf Verbindung > WLAN.
Wählen Sie ein Netzwerk aus und geben Sie bei Bedarf das zugehörige Passwort ein.
Hinweis: Die Smartwatch und dein Entwicklungscomputer müssen mit demselben Netzwerk verbunden sein. Nicht alle oder Zugangspunkten geeignet sind. Möglicherweise müssen Sie einen Zugangspunkt verwenden, dessen Firewall konfiguriert ist. um adb zu unterstützen.

WLAN-Fehlerbehebung aktivieren

Öffnen Sie auf der Smartwatch die Einstellungen.
Tippen Sie auf Entwickleroptionen > Debugging über WLAN.
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

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.
Notieren Sie sich den WLAN-Kopplungscode, die IP-Adresse und Anschluss.
Geben Sie in einem Terminalfenster auf Ihrem Entwicklungscomputer den folgenden Befehl ein:
```
adb pair IP_ADDRESS:PORT
```
Gib den WLAN-Kopplungscode aus Schritt 2 ein, wenn du dazu aufgefordert wirst. Das Terminal gibt an, ob die Kopplung erfolgreich war. Hier ein Beispiel:
```
Enter pairing code: 123456
Successfully paired to 192.168.1.100:5555
```

Nach dem Koppeln wird der Hostcomputer in der Liste der gekoppelten Geräte angezeigt auf dem Bildschirm Wireless Debugging (WLAN-Fehlerbehebung) Ihres Wear OS-Geräts.

Debugger mit der Smartwatch verbinden

Verbinden Sie Ihre Smartwatch und Ihren Entwicklungscomputer mit demselben Netzwerk.
Verbinde den Debugger über die IP-Adresse der Smartwatch und einen Port mit der Smartwatch Nummer. Lautet die IP-Adresse beispielsweise 192.168.1.100 und die Portnummer 5555 lautet, adb connect-Befehl und die zugehörige Antwort sehen 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. adb-Befehle senden mit dem Flag -s an die Smartwatch. Dabei werden die IP-Adresse und die Portnummer:

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: Bluetooth-Fehlerbehebung funktioniert nur bei gekoppelten Android-Geräten. Smartwatches mit Wear OS 2.

Koppeln Sie zuerst die Smartwatch mit dem Smartphone und aktivieren Sie die Entwickleroptionen auf der Smartwatch, wie oben beschrieben. Prüfen Sie, ob die Entwickleroptionen auf dem Smartphone aktiviert sind. Öffnen Sie dazu die Einstellungen und suchen Sie nach Entwickleroptionen. Aktivieren Sie bei Bedarf die Entwickleroptionen auf dem Smartphone.

USB-Debugging auf dem Smartphone aktivieren

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

ADB- oder Bluetooth-Fehlerbehebung auf der Smartwatch aktivieren

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

Bluetooth-Debugging auf dem Smartphone aktivieren

Öffnen Sie auf dem Smartphone die Wear OS-Companion-App.
Scrollen Sie zu Erweiterte Einstellungen und tippen Sie darauf, um die Erweiterte Einstellungen.
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 die Fehlerbehebung nur auf jeweils einem Gerät durchführen. 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.

Verbinden Sie das Smartphone über ein USB-Kabel mit dem Entwicklungscomputer.
Führen Sie die folgenden 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 verwenden Sie in beiden Befehlen denselben Port. In diesem Beispiel hat der Parameter Port 4444.
Nachdem du den Verbindungsbefehl eingegeben hast, fragt die Uhr dich, ob du sodass ADB Debugging erlaubt ist.
Prüfen Sie auf dem Smartphone auf der Statusanzeige in der Wear OS-Companion-App Folgendes:
```
Host: connected
Target: connected
```

Die Smartwatch ist jetzt mit dem Debugger verbunden und du kannst mit der Fehlerbehebung beginnen.

Wenn du Fehler auf einer Smartwatch über Bluetooth behebst, verwendet adb immer die IP-Adresse 127.0.0.1 plus dem 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 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 können Sie ein Video auch direkt auf Ihrem Wear OS-Gerät aufnehmen:

So nehmen Sie Rohframes 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
```
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: Besuchen Sie die FFmpeg-Website zum Download und Installationsanleitung.

Weitere Informationen finden Sie unter den folgenden Links: