App unter Wear OS erstellen und ausführen

Auf dieser Seite erfährst du, wie du mithilfe einer Vorlage aus Android Studio deine erste App für Wear OS erstellst. Die App zeigt die verschiedenen Möglichkeiten, Informationen auf Wear OS-Geräten auf einen Blick anzuzeigen, und führt einige Best Practices für die Entwicklung von Apps auf der Plattform ein.

Dieses Handbuch baut auf einigen Vorkenntnissen der Android-Plattform und der Android Studio-IDE auf. Wenn du Android zum ersten Mal verwendest, kannst du mit diesem Codelab eine App erstellen. 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 die Option Leere Wear-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. Rufen Sie Tools > SDK-Manager auf und installieren Sie Android 11.0 („R“) (API-Level 30) und Android 13.0 (Tiramisu) (API-Level 33).

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

Du kannst jetzt deine erste App auf Wear OS ausführen.

App im Emulator ausführen

Am einfachsten lässt sich deine erste Wear OS-App mit einem Emulator ausführen.

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. Gehen Sie zu Tools > Geräte-Manager.
  3. Klicken Sie auf Erstellen (+). Der Assistent für die Konfiguration virtueller Geräte wird angezeigt.
  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 Release-Namen Tiramisu aus. Dieser Release ist auf Android 13.0 (Wear OS 4) ausgerichtet. Wählen Sie für System-Images, die in China verwendet werden, den Releasenamen R aus. Dieser Release ist auf Android 11.0 (Wear OS 3) ausgerichtet. Klicken Sie auf Weiter.

    Hinweis:System-Images für den Wear OS-Emulator enthalten Hinweise zu Drittanbieterdateien und Quellcode. Sie können Hinweise von Drittanbietern für ein bestimmtes System-Image ansehen. Öffnen Sie dazu die Datei NOTICE.txt, die sich in einem der folgenden Verzeichnisse befindet:

    • $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 den Standardwert für alle Einstellungen auf diesem Bildschirm beibehalten, sofern Sie Ihren Emulator nicht anpassen möchten. Klicken Sie auf Fertig.

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

App im Emulator öffnen

  1. Gehen Sie zu Laufen > 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 kurzer Zeit 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 für verschiedene Anwendungsfälle testen.

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

Die Emulator-System-Images für Wear OS 4 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 den Programmiersprachen Kotlin oder Java geschrieben ist, prüfen Sie, ob Ihre App native 32-Bit- und 64-Bit-Bibliotheken enthält.

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

App auf einer physischen Smartwatch ausführen (optional)

Wenn du deine App auf einer echten Smartwatch ausführst und Fehler behebst, kannst du die gesamte Nutzererfahrung 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 Uhr ausführen möchten, bereiten Sie das Gerät für den Test vor und verbinden Sie es dann mit dem Entwicklungscomputer.

Smartwatch für Test vorbereiten

Aktivieren Sie die ADB-Fehlerbehebung, um Ihre Uhr für den Test vorzubereiten. Führen Sie dazu die folgenden Schritte aus.

  1. Öffnen Sie auf der Smartwatch das Menü Einstellungen.
  2. Scrolle im Menü nach unten. Wenn das Element Entwickleroptionen nicht angezeigt wird, führen Sie die folgenden Teilschritte 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. Suche das Element Build-Nummer und tippe 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-Debugging.

Smartwatch mit Entwicklungsmaschine verbinden

Bei einigen Smartwatches kann der Anschluss über USB erfolgen. Andere Geräte erfordern eine WLAN-Verbindung.

Kabelverbindung über USB einrichten

So kannst du die Uhr verbinden:

  1. Schließe die Smartwatch über ein USB-Kabel an deinen Entwicklungscomputer an.
  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, können Sie sie über WLAN oder Bluetooth verbinden.

Öffne die App auf der Smartwatch

  1. Gehen Sie zu Laufen > Gerät auswählen. Wählen Sie die Uhr 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 wenigen Augenblicken sollte die Meldung „Hello...“ auf der Uhr angezeigt werden.