Wear OS-Apps debuggen

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

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

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

Update auf die aktuelle Version von Wear OS

Damit Sie prüfen können, ob sich Ihre App auf der neuesten Software wie erwartet verhält, muss auf Ihrem Testgerät die aktuelle Version von Wear OS installiert sein, die von Ihrem Gerät unterstützt wird.

So prüfen Sie, ob ein Systemupdate für Ihr Testgerät verfügbar ist:

1. Verbinde 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. Rufen Sie auf Ihrem Testgerät die Einstellungen > System > Systemupdates auf.

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

Bestimmte Wear OS-Version installieren (optional)

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

Entwickleroptionen auf deiner Smartwatch aktivieren

Bevor Sie auf Ihrer Smartwatch debuggen können, müssen Sie die Entwickleroptionen aktivieren. Dies ist nur einmal erforderlich. Die Entwickleroptionen bleiben aktiviert, bis Sie sie deaktivieren. So aktivieren Sie die Entwickleroptionen:

1. Öffne die Einstellungen auf deiner Smartwatch.
2. Tippen Sie auf System > Info > Versionen.
3. Tippen Sie siebenmal auf das Element Build-Nummer.
4. Es wird eine Meldung angezeigt, in der bestätigt wird, dass Sie jetzt Entwickler sind.

Fehler über WLAN beheben

Bevor Sie beginnen, aktivieren Sie die Entwickleroptionen auf der Smartwatch, wie zuvor beschrieben.

Smartwatch mit einem WLAN verbinden

1. Öffne die Einstellungen auf deiner Smartwatch.
2. Tippen Sie auf Verbindung > WLAN.
3. Wählen Sie ein Netzwerk aus und geben Sie bei Bedarf das Passwort ein.

   Hinweis:Die Smartwatch und dein Entwicklercomputer müssen mit demselben Netzwerk verbunden sein. Nicht alle Zugangspunkte sind geeignet. Möglicherweise müssen Sie einen Access Point verwenden, dessen Firewall richtig für die Unterstützung von adb konfiguriert ist.

WLAN-Debugging aktivieren

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

Debugger mit der Smartwatch koppeln

1. Die Optionen für das kabellose Debugging finden Sie auf Ihrem Wear OS-Gerät in den Systemeinstellungen. Wählen Sie Neues Gerät koppeln aus.
2. Notiere dir 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 bei entsprechender Aufforderung den WLAN-Kopplungscode aus Schritt 2 ein. Das Terminal gibt aus, ob die Kopplung erfolgreich war. Beispiel:

   Enter pairing code: 123456
   Successfully paired to 192.168.1.100:5555
   

Debugger mit der Smartwatch verbinden

1. Verbinde deine Smartwatch und deinen Entwicklercomputer mit demselben Netzwerk.

2. Verbinden Sie den Debugger mit der Smartwatch über die IP-Adresse der Smartwatch und eine Portnummer. 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 Smartwatch ist jetzt mit dem Debugger verbunden und Sie können mit dem Debugging beginnen. Senden Sie adb-Befehle an die Smartwatch, indem Sie das Flag -s verwenden und die IP-Adresse und die Portnummer der Smartwatch angeben:

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.

Bevor Sie beginnen, koppeln Sie die Smartwatch und das Smartphone und aktivieren Sie die Entwickleroptionen auf der Smartwatch, wie zuvor beschrieben. Prüfe, ob die Entwickleroptionen auf dem Smartphone aktiviert sind. Öffne dazu die Einstellungen des Smartphones und suche nach Entwickleroptionen. Aktivieren Sie bei Bedarf die Entwickleroptionen auf dem Smartphone.

USB-Debugging auf dem Smartphone aktivieren

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

ADB- oder Bluetooth-Fehlerbehebung auf der Smartwatch aktivieren

1. Öffne auf deiner Smartwatch die Einstellungen.
2. Scrolle zu den Entwickleroptionen.
3. Prüfen Sie, ob ADB-Fehlerbehebung aktiviert ist.
4. Aktivieren Sie Debuggen ü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 Optionen für Erweiterte Einstellungen aufzurufen.
3. Aktiviere Debugging über Bluetooth. Unter der Option wird die folgende Statusmeldung angezeigt:

   Host: disconnected
   Target: connected
   

An diesem Punkt kommuniziert der Entwicklungscomputer – der Host – nicht mit der Smartwatch – dem Ziel. Sie müssen den Link vervollständigen.

Hinweis: Sie können jeweils nur mit einem Gerät debuggen. Wenn Sie mehrere Smartwatches gekoppelt haben, wird das Bluetooth-Debugging nur auf 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.

1. Verbinden Sie das Smartphone über ein USB-Kabel mit Ihrem Entwicklercomputer.
2. 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 denselben Port in beiden Befehlen. In diesem Beispiel ist der Port 4444.

3. Nachdem Sie den Befehl zum Verbinden eingegeben haben, werden Sie auf der Smartwatch aufgefordert, die ADB-Fehlerbehebung zu bestätigen.
4. Prüfen Sie auf dem Smartphone die Statusanzeige in der Wear OS Companion App auf Folgendes:

   Host: connected
   Target: connected
   

Die Smartwatch ist jetzt mit dem Debugger verbunden und Sie können mit dem Debugging 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 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>