App unter Wear OS erstellen und ausführen

Auf dieser Seite finden Sie eine Anleitung zum Erstellen Ihrer ersten App für Wear OS mit einer Vorlage aus Android Studio. 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.

In diesem Leitfaden wird vorausgesetzt, dass Sie bereits über einige Kenntnisse der Android-Plattform und der Android Studio IDE verfügen. Wenn Sie noch keine Android-App entwickelt haben, erstellen Sie eine App mit diesem Codelab. Weitere Informationen zu den Funktionen von Android Studio finden Sie auf der Seite Android Studio kennenlernen.

Wear OS-App erstellen

Nachdem Sie die aktuelle Version von Android Studio heruntergeladen und installiert haben, führen Sie den Assistenten für neue Projekte aus:

  1. Öffnen Sie Android Studio und wählen Sie File > New > New Project aus. 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-App aus.
  3. Geben Sie einen Namen für Ihr Projekt ein und klicken Sie dann auf Fertigstellen. Android Studio lädt die erforderlichen Abhängigkeiten herunter und erstellt die erste Version Ihres Projekts.

  4. Gehen Sie zu Tools > SDK Manager, klicken Sie auf Show Package Details und installieren Sie die folgenden Pakete:

    • Android 15.0 („VanillaIceCream“) (API-Ebene 35-ext15), einschließlich des Wear OS 5.1 ARM 64 v8a-Systemabbilds und des Wear OS 5.1 Intel x86 Atom_64-Systemabbilds.
    • Android 14.0 („UpsideDownCake“) (API-Level 34), das das Wear OS 5 ARM 64 v8a-Systemimage und das Wear OS 5 Intel x86 Atom_64-Systemimage umfasst.
    • Android 13.0 („Tiramisu“) (API-Level 33), das das Wear OS 4-Systemimage für ARM 64 v8a und das Wear OS 4-Systemimage für Intel x86 Atom_64 umfasst.

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

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

App im Emulator ausführen

Die einfachste Möglichkeit, Ihre erste Wear OS-App auszuführen, besteht darin, einen Emulator zu 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 aktuelle Version der Android SDK Platform-Tools haben. Schließen Sie den SDK Manager.
  2. Klicken Sie auf Tools > Device Manager (Tools > Geräteverwaltung).
  3. Wählen Sie Erstellen (+) aus. Der Assistent Konfiguration für virtuelles Gerät wird angezeigt.
  4. Wählen Sie im Bereich Kategorie die Option Wear OS und ein Hardwareprofil aus, z. B. Wear OS Small Round (Wear OS, klein und rund). Klicken Sie auf Weiter.

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

    Hinweis:System-Images für den Wear OS-Emulator enthalten Hinweise zu Drittanbieterdateien und ‑Quellcode. Sie können die Drittanbieterhinweise 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 Chinas 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, sofern Sie den Emulator nicht anpassen möchten. 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 Run > Select Device (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 Run . Der Emulator wird gestartet und Ihre App wird geöffnet.
  3. Nach einigen Augenblicken sollte im Emulator die Meldung „Hello…“ 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 in verschiedenen Anwendungsfällen 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 Ihre App nativen Code verwendet, der nicht in Kotlin oder Java geschrieben wurde, prüfen Sie, ob Ihre App sowohl native 32‑Bit- als auch 64‑Bit-Bibliotheken enthält.

Weitere Informationen zum Unterstützen von 64‑Bit-Architekturen

App auf einer physischen Smartwatch ausführen (optional)

Wenn Sie Ihre App auf einer echten Smartwatch ausführen und debuggen, können Sie die Nutzerfreundlichkeit besser beurteilen. Das ist besonders wichtig, wenn Ihre App auf bestimmte Hardware wie Sensoren oder eine GPU angewiesen ist.

Wenn Sie eine App auf einer physischen Smartwatch ausführen möchten, bereiten Sie das Gerät für Tests vor und verbinden Sie es dann mit Ihrem Entwicklungscomputer.

Smartwatch für den Test vorbereiten

Aktiviere das ADB-Debugging, um deine Smartwatch für Tests vorzubereiten.

  1. Öffnen Sie auf der Smartwatch das Menü Einstellungen.
  2. Scrollen Sie im Menü bis ganz nach unten. Wenn kein Eintrag Entwickleroptionen 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 > Über das Gerät oder System > Über das Gerät > Versionen.
    2. Suchen Sie nach dem Eintrag Build-Nummer und tippen Sie siebenmal darauf. Wenn deine Smartwatch durch eine PIN oder ein Muster geschützt ist, gib diese ein, wenn du dazu aufgefordert wirst.
  3. Tippen Sie in den Einstellungen auf Entwickleroptionen.
  4. Aktivieren Sie die Option ADB-Fehlerbehebung.

Smartwatch mit dem Entwicklercomputer verbinden

Bei einigen Smartwatches können Sie eine Verbindung über USB herstellen. Für andere ist eine kabellose Verbindung erforderlich.

Kabelverbindung über USB einrichten

So verbindest du die Smartwatch:

  1. Verbinden Sie die Smartwatch über ein USB-Kabel mit Ihrem Entwicklungscomputer.
  2. Aktiviere auf der Smartwatch Von diesem Computer immer zulassen und tippe dann auf OK.

WLAN-Verbindung einrichten

Wenn deine Smartwatch keinen USB-Anschluss hat, erfährst du hier, wie du eine Smartwatch über WLAN oder Bluetooth verbindest.

Bestimmte Wear OS-Version installieren (optional)

Wenn der Testlauf Ihrer App von einer bestimmten Version von Wear OS abhängt, können Sie ein Software-Image auf Smartwatches flashen, die eine kabelgebundene 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.

App auf der Smartwatch öffnen

  1. Gehen Sie zu Run > Select Device (Ausführen > Gerät auswählen). Wähle die Smartwatch aus, die mit deiner Maschine verbunden ist.
  2. Klicken Sie in der Android Studio-Symbolleiste auf Run . Der Emulator wird gestartet und Ihre App wird geöffnet.
  3. Nach einigen Augenblicken sollte auf der Smartwatch die Meldung „Hallo…“ angezeigt werden.