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, <ph type="x-smartling-placeholder"></ph> 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 zur Einrichtung eine Verbindung zum Testen, besuchen Sie eine Smartwatch mit einem Smartphone

Hinweis : Wenn Sie keine physische Smartwatch haben, können Sie Testen und ausführen in einem Emulator in Android Studio.

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 suchen Sie auf Ihrem Testgerät nach einem Systemupdate:

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

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

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

Bestimmte Version von Wear OS installieren (optional)

Wenn der Testlauf Ihrer App von einer bestimmten Wear OS-Version abhängt, haben Sie folgende Möglichkeiten: ein Software-Image auf Uhren flashen, die eine USB-Datenverbindung unterstützen. Für Sie können beispielsweise eine Factory Image oder Vollständiges OTA-Image auf Google Pixel Watch 2.

Entwickleroptionen auf deiner Smartwatch aktivieren

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

1. Öffnen Sie auf der Smartwatch die Einstellungen.
2. Tippen Sie auf System > Über > 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

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

Verbinde die Uhr mit einem WLAN-Netzwerk

1. Öffnen Sie auf der Smartwatch die Einstellungen.
2. Tippen Sie auf Konnektivität > WLAN.
3. Wählen Sie ein Netzwerk aus und geben Sie gegebenenfalls das Passwort ein.

   Hinweis: Die Smartwatch und dein Entwicklungscomputer müssen mit demselben Netzwerk verbunden sein. Nicht alle Zugangspunkte geeignet. Möglicherweise müssen Sie einen Zugangspunkt verwenden, dessen Firewall konfiguriert ist. um adb zu unterstützen.

WLAN-Fehlerbehebung aktivieren

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

Debugger mit der Smartwatch koppeln

1. Suche auf deinem Wear OS-Gerät die Optionen zum Debugging über WLAN im System Einstellungen. Wählen Sie Neues Gerät koppeln aus.
2. Notieren Sie sich den WLAN-Kopplungscode, die IP-Adresse und Anschluss.
3. Geben Sie in einem Terminalfenster auf Ihrem Entwicklungscomputer Folgendes ein: Befehl:

   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. Hier ein Beispiel:

   Enter pairing code: 123456
   Successfully paired to 192.168.1.100:5555
   

Debugger mit der Smartwatch verbinden

1. Verbinde deine Smartwatch und dein Entwicklungssystem mit demselben Netzwerk.

2. 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 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 du kannst mit dem Debugging 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 Debugging angeschlossen haben, wird der die Adresse angeben:

adb <command>

Debugging über Bluetooth

Hinweis: Bluetooth-Fehlerbehebung funktioniert nur bei gekoppelten Android-Geräten. Smartwatches mit Wear OS 2.

Bevor Sie Smartwatch und Smartphone koppeln und Entwickleroptionen aktivieren auf wie zuvor beschrieben. Prüfen Sie, ob die Entwickleroptionen auf der indem Sie die Einstellungen und suchen Sie nach Entwickleroptionen. Aktivieren Sie bei Bedarf die Entwickler- auf dem Smartphone.

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-Debugging auf der Smartwatch aktivieren

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

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 Erweiterte Einstellungen.
3. Aktivieren Sie Debugging über Bluetooth. Die folgende Statusmeldung erscheint unter der Option:

   Host: disconnected
   Target: connected
   

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

Hinweis: Sie können die Fehlerbehebung nur auf jeweils einem Gerät durchführen. Wenn mehrere Smartwatches gekoppelt sind, ist die Bluetooth-Fehlerbehebung nur aktiviert. mit dem ausgewählten Gerät auf dem Hauptbildschirm.

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. Beliebigen verfügbaren Port verwenden auf dem Entwicklungscomputer und verwenden in beiden Befehlen denselben Port. In diesem Beispiel hat der Parameter Port 4444.

3. Nachdem du den Verbindungsbefehl eingegeben hast, fragt die Uhr dich, ob du sodass ADB Debugging erlaubt ist.
4. 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 lautet der Port 4444. Alle adb-Befehle verwenden die Methode folgendes Format:

adb -s 127.0.0.1:4444 <command> 

Wenn Sie den Emulator nicht verwenden und nur ein Gerät zum Debugging angeschlossen haben, wird der die Adresse angeben:

adb <command>

Bildschirmaufzeichnung für Wear OS verwenden

Wenn Sie unter macOS entwickeln, können Sie das GitHub-Projekt verwenden <ph type="x-smartling-placeholder"></ph> Android-Tool für Mac, um ein Video auf Ihrem Wear OS-Gerät aufzunehmen.

Alternativ können Sie ein Video mit Ihrem Wear OS-Gerät aufnehmen. Gehen Sie dazu so vor:

1. Zeichne Rohframes auf der Uhr auf:

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

2. Kopieren Sie die RAW-Datei auf Ihren Entwicklungscomputer:

   adb pull /sdcard/video.raw video.raw

3. Konvertiere die Datei mit ffmpeg in das MP4-Format:

   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: Sie können die Datei auf der FFmpeg-Website herunterladen und Installationsanleitung.