Auf dieser Seite findest du eine Anleitung zum Erstellen deiner ersten App für Wear OS mit einer Vorlage aus Android Studio. Die App demonstriert die verschiedenen Möglichkeiten, Informationen auf Wear OS-Geräte auf einen Blick zu sehen, und bietet einige Best Practices für die Entwicklung von Apps auf der Plattform.
Dieser Leitfaden baut auf einigen Vorkenntnissen über die Android-Plattform und die Android Studio-IDE auf. Wenn Sie Android zum ersten Mal verwenden, 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 neueste Version von Android Studio heruntergeladen und installiert haben, führen Sie den Assistenten für ein neues Projekt aus:
- Öffnen Sie Android Studio und rufen Sie File > New > New Project auf. Das Fenster Neues Projekt wird angezeigt.
- Wählen Sie im Bereich Vorlagen die Option Wear OS aus. Wählen Sie dann im Hauptbereich Empty Wear App (Leere Wear-App leeren) aus.
- Benennen Sie Ihr Projekt und klicken Sie dann auf Fertigstellen. Android Studio lädt die erforderlichen Abhängigkeiten herunter und erstellt die anfängliche Version Ihres Projekts.
Rufen Sie Tools > SDK-Manager auf und installieren Sie sowohl Android 11.0 („R“) (API-Level 30) als auch 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 Ihre erste Wear OS-App mit einem Emulator ausführen.
Emulator konfigurieren
Führe die folgenden Schritte aus, um einen Emulator in Android Studio zu konfigurieren:
- Öffnen Sie im SDK-Manager den Tab SDK Tools. Prüfen Sie, ob Sie die neueste Version der Android SDK Platform-Tools verwenden.
- Gehen Sie zu Tools > Geräte-Manager.
- Wählen Sie Create (+) (Erstellen) aus. Der Assistent für die Konfiguration virtueller Geräte wird angezeigt.
- Wählen Sie im Bereich Kategorie die Option Wear OS und dann ein Hardwareprofil aus, z. B. Wear OS Small Round. Klicken Sie auf Weiter.
Wählen Sie für System-Images, die außerhalb von China verwendet werden, den Releasenamen Tiramisu aus. Dieser Release ist für Android 13.0 (Wear OS 4) vorgesehen. 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 auf Dateien von Drittanbietern und Quellcode. Sie können Hinweise von Drittanbietern für ein bestimmtes Systemimage aufrufen. Öffnen Sie dazu die Datei
NOTICE.txt. Sie befindet sich in einem der folgenden Verzeichnisse:$ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABIfür Emulatoren, die außerhalb von China verwendet werden.$ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABIfür Emulatoren, die in China verwendet werden.
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
- Gehen Sie zu Ausführen > Gerät auswählen. Wählen Sie den soeben erstellten Emulator aus.
- Klicken Sie in der Symbolleiste von Android Studio auf Run
. Der Emulator startet und öffnet Ihre App. - Nach kurzer Zeit sollte im Emulator die Meldung "Hello" angezeigt werden.
Bluetooth-Audio mit dem Emulator testen
Bei System-Images, die Wear OS 4 oder höher ausführen, unterstützt der Emulator emuliertes Bluetooth, mit dem Sie Bluetooth-Audio in mehreren Anwendungsfällen testen können.
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 sowohl native 32- als auch 64-Bit-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 Fehler beheben, können Sie die gesamte Nutzererfahrung besser beurteilen. Das ist besonders wichtig, wenn Ihre Anwendung auf bestimmter Hardware wie Sensoren oder einer GPU basiert.
Um eine App auf einer physischen Uhr auszuführen, bereiten Sie das Gerät für den Test vor und verbinden Sie es dann mit Ihrem Entwicklungscomputer.
Smartwatch auf Tests vorbereiten
Aktivieren Sie die ADB-Fehlerbehebung, um die Smartwatch für den Test vorzubereiten. Führen Sie dazu die folgenden Schritte aus.
- Öffnen Sie auf der Smartwatch das Menü Einstellungen.
- 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.
- Tippen Sie auf System > Info oder System > Info > Versionen.
- Suchen Sie nach dem Element 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.
- Tippen Sie im Menü Einstellungen auf Entwickleroptionen.
- Aktivieren Sie die Option ADB-Debugging.
Uhr mit Entwicklungsmaschine verbinden
Einige Smartwatches lassen sich über USB verbinden. Andere Geräte erfordern eine kabellose Verbindung.
Kabelverbindung über USB einrichten
Verbinde die Uhr mithilfe der folgenden Schritte:
- Verbinde die Uhr über ein USB-Kabel mit deinem Entwicklungscomputer.
- Aktivieren Sie auf der Smartwatch die Option Von diesem Computer immer zulassen und tippen Sie dann auf OK.
Drahtlose Verbindung einrichten
Wenn Ihre Smartwatch keinen USB-Port hat, erfahren Sie hier, wie Sie eine Smartwatch über WLAN oder Bluetooth verbinden.
Öffne die App auf der Smartwatch
- Gehen Sie zu Ausführen > Gerät auswählen. Wähle die Uhr aus, die mit deinem Rechner verbunden ist.
- Klicken Sie in der Symbolleiste von Android Studio auf Run
. Der Emulator startet und öffnet Ihre App.
- Nach wenigen Augenblicken sollte auf der Uhr die Meldung „Hallo...“ angezeigt werden.