Jetpack Compose unter Wear OS verwenden

Compose for Wear OS ähnelt Compose für Mobilgeräte. Es gibt jedoch einige wichtige Unterschiede. In diesem Leitfaden werden die Gemeinsamkeiten und Unterschiede erläutert.

Compose for Wear OS ist Teil von Android Jetpack und wie die anderen Wear Jetpack-Bibliotheken hilft es Ihnen, schneller besseren Code zu schreiben. Dies ist unser empfohlener Ansatz zum Erstellen von Benutzeroberflächen für Wear OS-Apps.

Wenn Sie mit dem Jetpack Compose-Toolkit nicht vertraut sind, sehen Sie sich den Compose-Lernpfad an. Viele der Entwicklungsprinzipien für mobiles Compose gelten auch für Compose for Wear OS. Weitere Informationen zu den allgemeinen Vorteilen eines deklarativen UI-Frameworks finden Sie unter Warum Compose? Weitere Informationen zu Compose for Wear OS finden Sie im Lernpfad Compose for Wear OS und im Wear OS-Beispiel Repository auf GitHub.

Material Design in Jetpack Compose unter Wear OS

Jetpack Compose unter Wear OS bietet eine Implementierung von Material 3, mit der Sie ansprechendere Apps erstellen können. Die Material Design-Komponenten unter Wear OS basieren auf dem Wear Material-Theming. Dieses Theming ist eine systematische Möglichkeit, Material Design anzupassen und die Marke Ihres Produkts besser widerzuspiegeln.

Kompatibilität

Plattformen

Mit Compose for Wear OS können Sie einfacher Apps unter Wear OS erstellen. Weitere Informationen finden Sie unter Apps. Mit unseren integrierten Komponenten können Sie Benutzeroberflächen erstellen, die den Wear OS-Richtlinien entsprechen. Weitere Informationen zu Komponenten finden Sie in unseren Designrichtlinien.

Einrichten

Die Verwendung von Jetpack Compose mit Wear OS ähnelt der Verwendung von Jetpack Compose für andere Android-Projekte. Der Hauptunterschied besteht darin, dass Jetpack Compose for Wear Wear-spezifische Bibliotheken hinzufügt, mit denen sich einfacher Benutzeroberflächen erstellen lassen, die auf Smartwatches zugeschnitten sind. In einigen Fällen haben diese Komponenten denselben Namen wie ihre Pendants für Mobilgeräte, z. B. androidx.wear.compose.material3.Button und androidx.compose.material3.Button.

Neue App in Android Studio erstellen

So erstellen Sie ein neues Projekt mit Jetpack Compose:

1. Klicken Sie im Fenster Willkommen bei Android Studio auf Neues Android Studio-Projekt starten. Wenn Sie bereits ein Android Studio-Projekt geöffnet haben, wählen Sie in der Menüleiste Datei > Neu > Beispiel importieren aus.
2. Suchen Sie nach Compose for Wear und wählen Sie Compose for Wear OS Starter aus.
3. Führen Sie im Fenster Projekt konfigurieren folgende Schritte aus:
   1. Legen Sie den Anwendungsnamen fest.
   2. Wählen Sie den Projektstandort für Ihr Beispiel aus.
4. Klicken Sie auf Fertig.
5. Prüfen Sie, ob die Datei build.gradle des Projekts korrekt konfiguriert ist, wie unter Gradle-Eigenschaftsdateien beschrieben.

Jetzt können Sie mit der Entwicklung einer App mit Compose for Wear OS beginnen.

Abhängigkeiten des Jetpack Compose-Toolkits

Wenn Sie Jetpack Compose mit Wear OS verwenden möchten, müssen Sie die Abhängigkeiten des Jetpack Compose-Toolkits in die Datei build.gradle Ihrer App einfügen. Die meisten Änderungen an den Abhängigkeiten im Zusammenhang mit Wear OS befinden sich in den obersten Architekturschichten, die im folgenden Bild rot umrandet sind.

<img 'foundation',="" 'material',="" 'runtime'.="" 'ui',="" 2="" 4="" a="" alt="" and="" are="" bottom,="" box""="" by="" contain="" from="" rectangles="" rectangles.="" red="" src="/static/wear/images/components/ComposeDependencies.png" surrounded="" the="" to="" top="" />

Das bedeutet, dass sich viele der Abhängigkeiten, die Sie bereits mit Jetpack Compose verwenden, nicht ändern, wenn Sie Wear OS als Zielplattform festlegen. Die Abhängigkeiten für UI, Laufzeit, Compiler und Animation bleiben beispielsweise gleich.

Wear OS hat jedoch eigene Versionen der Bibliotheken material und material3, foundation und navigation. Prüfen Sie daher, ob Sie die richtigen Bibliotheken verwenden.

Verwenden Sie nach Möglichkeit die WearComposeMaterial -Version der APIs. Es ist zwar technisch möglich, die mobile Version von Compose Material zu verwenden, sie ist jedoch nicht für die besonderen Anforderungen von Wear OS optimiert. Außerdem kann die Kombination von Compose Material mit Compose Material for Wear OS zu unerwartetem Verhalten führen. Da jede Bibliothek eine eigene MaterialTheme-Klasse hat, können beispielsweise Farben, Typografie oder Formen inkonsistent sein, wenn beide Versionen verwendet werden.

In der folgenden Tabelle sind die Unterschiede bei den Abhängigkeiten zwischen Wear OS und Mobilgeräten aufgeführt:

Das folgende Snippet zeigt ein Beispiel für eine build.gradle-Datei, die diese Abhängigkeiten enthält:

dependencies {

    val composeBom = platform("androidx.compose:compose-bom:2026.03.00")

    // General compose dependencies
    implementation(composeBom)
    implementation("androidx.activity:activity-compose:1.13.0")
    implementation("androidx.compose.ui:ui-tooling-preview:1.11.0")
    // Other compose dependencies

    // Compose for Wear OS dependencies
    implementation("androidx.wear.compose:compose-material3:1.6.1")

    // Foundation is additive, so you can use the mobile version in your Wear OS app.
    implementation("androidx.wear.compose:compose-foundation:1.6.1")

    // Wear OS preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.6.1")

    // If you are using Compose Navigation, use the Wear OS version (NOT THE MOBILE VERSION).
    // Uncomment the line below and update the version number.
    // implementation("androidx.wear.compose:compose-navigation:1.6.1")

    // Testing
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.3")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.4.0")
    androidTestImplementation("androidx.compose.ui:ui-test-junit4:1.0.3")
    debugImplementation("androidx.compose.ui:ui-tooling:1.4.1")

}