App unter Wear OS erstellen und ausführen

Auf dieser Seite erfahren Sie, wie Sie mit einer Vorlage aus Android Studio Ihre erste App für Wear OS erstellen. Die App zeigt die verschiedenen Möglichkeiten, Informationen auf Wear OS-Geräten auf einen Blick zu sehen, und stellt einige Best Practices für die Entwicklung von Apps auf der Plattform vor.

Dieser Leitfaden setzt einige Vorkenntnisse über die Android-Plattform und die Android Studio IDE voraus. Wenn Sie noch keine Erfahrung mit Android haben, erstellen Sie mit diesem Codelab eine App. Weitere Informationen zu den Funktionen von Android Studio finden Sie auf der Seite Android Studio kennenlernen.

Wear OS-App erstellen

Nachdem Sie die neueste Version von Android Studio heruntergeladen und installiert haben, führen Sie den Assistenten „Neues Projekt“ aus:

  1. Öffnen Sie Android Studio und klicken Sie dann auf File > New > New Project (Datei > Neu > Neues Projekt). Das Fenster Neues Projekt wird angezeigt.
  2. Wählen Sie im Bereich Vorlagen die Option Wear OS aus. Wählen Sie dann im Hauptbereich Leere Wear OS-App aus.
  3. Benennen Sie Ihr Projekt und klicken Sie dann auf Finish (Fertigstellen). Android Studio lädt die erforderlichen Abhängigkeiten herunter und erstellt die erste Version Ihres Projekts.

  4. Gehen Sie zu Tools > SDK-Manager und installieren Sie beide der folgenden Pakete:

    • Android 14.0 („UpsideDownCake“) (API-Level 34), einschließlich des Wear OS 5 – ARM 64 v8a-System-Images und des Wear OS 5 – Intel x86 Atom_64-System-Images.
    • Android 13.0 („Tiramisu“) (API-Level 33), einschließlich des Wear OS 4 ARM 64 v8a-System-Images und des Wear OS 4 Intel x86 Atom_64-System-Images.

    Klicken Sie auf OK, um den SDK-Manager zu schließen.

Sie können jetzt Ihre erste App unter Wear OS ausführen.

App im Emulator ausführen

Am einfachsten können Sie Ihre erste Wear OS-App ausführen, indem Sie einen Emulator konfigurieren.

Emulator konfigurieren

So konfigurieren Sie einen Emulator in Android Studio:

  1. Öffnen Sie im SDK-Manager den Tab SDK-Tools. Prüfen Sie, ob Sie die neueste Version der Android SDK Platform-Tools haben.
  2. Klicken Sie auf Tools > Gerätemanager.
  3. Wählen Sie Erstellen (+) aus. Der Assistent Konfiguration virtueller Geräte wird geöffnet.
  4. Wähle im Bereich Kategorie die Option Wear OS und dann ein Hardwareprofil aus, z. B. Wear OS Small Round. Klicken Sie auf Weiter.

  5. Wählen Sie für System-Images, die außerhalb von China verwendet werden, den Releasenamen UpsideDownCake aus. Diese Version ist auf Android 14.0 (Wear OS 5) ausgerichtet. Wählen Sie für System-Images, die in China verwendet werden, den Release-Namen R aus. Dieser Release ist auf Android 11.0 (Wear OS 3) ausgerichtet. Wenn Sie noch kein Wear OS 5-System-Image installiert haben, das Ihrer Gerätedefinition entspricht, klicken Sie neben dem Release-Namen auf Herunterladen, um es herunterzuladen. Klicken Sie auf Weiter.

    Hinweis:System-Images für den Wear OS-Emulator enthalten Hinweise auf Dateien und Quellcode von Drittanbietern. Sie können die Hinweise von Drittanbietern für ein bestimmtes System-Image aufrufen, indem Sie die Datei NOTICE.txt in einem der folgenden Verzeichnisse öffnen:

    • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABI für Emulatoren, die außerhalb von China verwendet werden.
    • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI für Emulatoren, die in China verwendet werden.

  6. Sie können die Standardwerte für alle Einstellungen auf diesem Bildschirm beibehalten, es sei denn, Sie möchten den Emulator anpassen. Klicken Sie auf Fertig.

Weitere Informationen zur Verwendung von Emulatoren finden Sie im Leitfaden zum Ausführen von Apps im Android-Emulator.

App im Emulator öffnen

  1. Gehen Sie zu Ausführen > Gerät auswählen. Wählen Sie den Emulator aus, den Sie gerade erstellt haben.
  2. Klicken Sie in der Android Studio-Symbolleiste auf Ausführen . Der Emulator startet und öffnet Ihre App.
  3. Nach einigen Augenblicken sollte im Emulator die Meldung „Hallo…“ angezeigt werden.

Bluetooth-Audio mit dem Emulator testen

Auf System-Images mit Wear OS 4 oder höher unterstützt der Emulator emuliertes Bluetooth. So können Sie Bluetooth-Audio für verschiedene Anwendungsfälle testen.

Aktuelle System-Images unterstützen nur 64-Bit-Architekturen

Die Emulator-System-Images für Wear OS 4 und höher unterstützen nur die folgenden 64-Bit-Architekturen: x86-64 und arm64-v8a. Wenn Sie wissen oder vermuten, dass in Ihrer App nativer Code verwendet wird, der nicht in den Programmiersprachen Kotlin oder Java geschrieben wurde, prüfen Sie, ob Ihre App sowohl 32-Bit- als auch 64-Bit-native Bibliotheken enthält.

Weitere Informationen zur Unterstützung von 64-Bit-Architekturen

App auf einer Smartwatch ausführen (optional)

Wenn du deine App auf einer echten Uhr ausführst und Fehler behebst, kannst du die gesamte Benutzererfahrung besser beurteilen. Das ist besonders wichtig, wenn Ihre App auf bestimmte Hardware angewiesen ist, z. B. auf Sensoren oder eine GPU.

Wenn Sie eine App auf einer Smartwatch ausführen möchten, müssen Sie das Gerät für den Test vorbereiten und dann mit Ihrem Entwicklungscomputer verbinden.

Smartwatch für Test vorbereiten

Aktivieren Sie das ADB-Debugging, um Ihre Smartwatch für den Test vorzubereiten. Gehen Sie dazu so vor:

  1. Öffnen Sie auf der Smartwatch das Menü Einstellungen.
  2. Scrollen Sie im Menü ganz nach unten. Wenn der Eintrag Entwickleroptionen nicht angezeigt wird, führen Sie die folgenden Unterschritte aus. Ist dies nicht der Fall, fahren Sie mit dem nächsten Schritt fort.
    1. Tippen Sie auf System > Info oder System > Info > Versionen.
    2. Suchen Sie den Eintrag Build-Nummer und tippen Sie siebenmal darauf. Wenn deine Uhr durch eine PIN oder ein Muster geschützt ist, gib diese ein, wenn du dazu aufgefordert wirst.
  3. Tippen Sie im Menü Einstellungen auf Entwickleroptionen.
  4. Aktivieren Sie die Option ADB-Fehlerbehebung.

Smartwatch mit Entwicklungsmaschine verbinden

Bei einigen Smartwatches ist eine Verbindung über USB möglich. Für andere ist eine WLAN-Verbindung erforderlich.

Kabelgebundene Verbindung über USB einrichten

So stellen Sie eine Verbindung her:

  1. Verbinden Sie die Smartwatch über ein USB-Kabel mit Ihrem Entwicklungscomputer.
  2. Aktivieren Sie auf der Smartwatch die Option Auf diesem Computer immer zulassen und tippen Sie dann auf OK.

Drahtlose Verbindung einrichten

Wenn Ihre Smartwatch keinen USB-Anschluss hat, erfahren Sie hier, wie Sie sie über WLAN oder Bluetooth verbinden.

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 (kabelgebunden) unterstützen. Du kannst beispielsweise ein Fabrik-Image oder ein vollständiges OTA-Image auf eine Google Pixel Watch 3 oder Google Pixel Watch 2 flashen.

App auf der Smartwatch öffnen

  1. Gehen Sie zu Ausführen > Gerät auswählen. Wählen Sie die Smartwatch aus, die mit Ihrem Computer verbunden ist.
  2. Klicken Sie in der Android Studio-Symbolleiste auf Ausführen . Der Emulator startet und öffnet Ihre App.
  3. Nach einigen Augenblicken sollte auf der Smartwatch die Meldung „Hallo…“ angezeigt werden.