Jetpack Compose unter Wear OS verwenden

Compose für 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 für Wear OS ist Teil von Android Jetpack und hilft dir wie die anderen Wear Jetpack-Bibliotheken, schneller besseren Code zu schreiben. Dies ist unser empfohlener Ansatz zum Erstellen von Benutzeroberflächen für Wear OS-Apps.

Wenn du mit dem Jetpack Compose-Toolkit nicht vertraut bist, sieh dir den Compose-Pfad an. Viele der Entwicklungsprinzipien für Compose für Mobilgeräte gelten auch für Compose für Wear OS. Weitere Informationen zu den allgemeinen Vorteilen eines deklarativen UI-Frameworks finden Sie unter Warum Compose?. Weitere Informationen zu Compose für Wear OS finden Sie im Lernpfad zu Compose für Wear OS und im Repository mit Wear OS-Beispielen auf GitHub.

android skills add wear-compose-m3

Material Design in Jetpack Compose unter Wear OS

Jetpack Compose für Wear OS bietet eine Implementierung von Material 3, mit dem du ansprechendere App- Erlebnisse gestalten kannst. Die Material Design-Komponenten für Wear OS basieren auf Wear Material Theming. Dieses Design ist eine systematische Möglichkeit, Material Design anzupassen und die Marke Ihres Produkts besser widerzuspiegeln.

Kompatibilität

Plattformen

Mit Compose für Wear OS wird das Erstellen von Apps für Wear OS vereinfacht. Weitere Informationen finden Sie unter Apps. Verwende unsere integrierten Komponenten, um eine Nutzererfahrung zu schaffen, die den Wear OS-Richtlinien entspricht. 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 für Wear Wear-spezifische Bibliotheken hinzufügt, mit denen sich Benutzeroberflächen für Smartwatches einfacher erstellen lassen. In einigen Fällen haben diese Komponenten denselben Namen wie ihre Nicht-Wear-Entsprechungen, z. B. androidx.wear.compose.material3.Button und androidx.compose.material3.Button.

Neue App in Android Studio erstellen

So erstellen Sie ein neues Projekt, das Jetpack Compose enthält:

1. Wenn Sie sich im Fenster Welcome to Android Studio befinden, klicken Sie auf Start a new Android Studio project. Wenn Sie bereits ein Android Studio-Projekt geöffnet haben, wählen Sie in der Menüleiste File > New > Import Sample 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 die folgenden Schritte aus:
   1. Legen Sie den Anwendungsnamen fest.
   2. Wählen Sie den Projektspeicherort für Ihr Beispiel aus.
4. Klicken Sie auf Fertig.
5. Prüfen Sie, ob die Datei build.gradle des Projekts richtig konfiguriert ist, wie unter Gradle-Attributdateien beschrieben.

Jetzt können Sie mit der Entwicklung einer App mit Compose für 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 build.gradle-Datei Ihrer App aufnehmen. Die meisten Abhängigkeitsänderungen im Zusammenhang mit Wear OS befinden sich in den oberen Architekturebenen, die im folgenden Bild rot umrandet sind.

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

Wear OS hat jedoch eigene Versionen der Bibliotheken material und material3, foundation und navigation. Prüfe daher, ob du die richtigen Bibliotheken verwendest.

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 für Wear OS zu unerwartetem Verhalten führen. Da jede Bibliothek eine eigene MaterialTheme-Klasse hat, kann es beispielsweise zu Inkonsistenzen bei Farben, Typografie oder Formen kommen, 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 eine build.gradle-Beispieldatei, die diese Abhängigkeiten enthält:

dependencies {

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

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

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

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

    // Wear OS preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.7.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.7.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")

}