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.

Hinweis: Wenn Sie die neuesten für den Emulator verfügbaren Systembilder verwenden möchten, installieren Sie Android Studio Hedgehog oder höher.

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 wählen Sie File > New > New Project (Datei > Neu > Neues Projekt) 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 OS-App aus.
3. Benennen Sie Ihr Projekt und klicken Sie dann auf Fertigstellen. Android Studio lädt die erforderlichen Abhängigkeiten herunter und erstellt die erste Version Ihres Projekts.

4. Gehe zu Tools > SDK Manager, klicke auf Paketdetails anzeigen und installiere die folgenden Pakete:

   • Android 15.0 („VanillaIceCream“) (API-Ebene 35-ext15), einschließlich des Wear OS 5.1 ARM 64 v8a-System-Images und des Wear OS 5.1 Intel x86 Atom_64-System-Images.
   • 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.
   Hinweis :Die neueste stabile Version von Wear OS, Wear OS 5.1, basiert auf Android 15.

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

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

Hinweis :Standardmäßig erstellt der Assistent „Neues Projekt“ eine eigenständige, unabhängige Wear OS-App, die zum Ausführen nicht mit einem anderen Gerät verbunden werden muss.

Eine Wear OS-App sollte unabhängig von einer Smartphone-App funktionieren, damit Nutzer die größtmögliche Flexibilität bei der Auswahl ihres Smartphones haben. Wenn Sie aufgrund der Komplexität oder der Funktionen Ihrer App eine Verbindung zu einem Smartphone herstellen müssen, lesen Sie die Anleitung zum Verbinden einer Smartwatch mit einem Smartphone.

App im Emulator ausführen

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

Hinweis :Wenn Sie Ihre Wear OS-Apps in China anbieten möchten, lesen Sie auch den Hilfeartikel Wear OS-Apps für China erstellen.

Emulator konfigurieren

So konfigurieren Sie einen Emulator in Android Studio:

1. Öffne 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ählen Sie im Bereich Kategorie die Option Wear OS und dann ein Hardwareprofil aus, z. B. 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 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. Diese Version ist für Android 11.0 (Wear OS 3) vorgesehen. 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 gerade erstellten Emulator aus.
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, auf denen Wear OS 4 oder höher ausgeführt wird, 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 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 Sie Ihre App auf einer echten Smartwatch ausführen und beheben, können Sie die Nutzerfreundlichkeit insgesamt besser beurteilen. Das ist besonders wichtig, wenn Ihre App auf spezifische Hardware wie Sensoren oder eine GPU angewiesen ist.

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 den 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 Ihre Smartwatch durch eine PIN oder ein Muster geschützt ist, geben Sie diese ein, wenn Sie dazu aufgefordert werden.
3. Tippen Sie im Menü Einstellungen auf Entwickleroptionen.
4. Aktivieren Sie die Option ADB-Fehlerbehebung.

Smartwatch mit dem Entwicklungscomputer 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 Von diesem Computer immer zulassen und tippen Sie dann auf OK.

WLAN 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. 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.

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.