Ansichtsbasierte UIs unter Wear OS erstellen
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Compose ausprobieren
Jetpack Compose für Wear OS ist das empfohlene UI-Toolkit für Wear OS.
Android Jetpack enthält die Wear OS-UI-Bibliothek.
Die Wear OS-UI-Bibliothek enthält die folgenden Klassen:
-
CurvedTextView: Eine Komponente zum einfachen Schreiben von Text, der der Krümmung des größten Kreises folgt, der in die Ansicht eingezeichnet werden kann.
-
DismissibleFrameLayout: Ein Layout, mit dem Nutzer jede Ansicht schließen können, indem sie die Schaltfläche „Zurück“ drücken oder auf dem Display von links nach rechts wischen.
Wear OS-Nutzer erwarten, dass sie zum Zurückgehen von links nach rechts wischen.
-
WearableRecyclerView: Eine Ansicht, die eine grundlegende Offset-Logik zum Aktualisieren von untergeordneten Layouts mithilfe eines
WearableLinearLayoutManager bietet.
-
AmbientModeSupport: Eine Klasse, die mit der
AmbientModeSupport.AmbientCallbackProvider-Schnittstelle verwendet wird, um den Bildschirmschoner zu unterstützen.
Eine vollständige Liste finden Sie in den Versionshinweisen.
Abhängigkeit von der Wear OS-UI-Bibliothek hinzufügen
Wenn Sie mit dem Erstellen von Apps beginnen möchten, erstellen Sie ein Wear OS-spezifisches Projekt. Fügen Sie dann der Datei build.gradle Ihrer App die folgenden Abhängigkeiten hinzu:
dependencies {
...
// Standard Wear OS libraries
implementation "androidx.wear:wear:1.2.0"
// includes support for wearable specific inputs
implementation "androidx.wear:wear-input:1.1.0"
}
Klassen aus dem Wear OS UI Library-Paket importieren
Wenn Sie eine Klasse aus der Wear OS-UI-Bibliothek verwenden möchten, importieren Sie sie aus dem Paket androidx.wear.widget.
Die richtigen Elementnamen in Layoutdateien verwenden
Verwenden Sie in Layoutdateien vollständig qualifizierte Namen, die der Wear OS-UI-Bibliothek entsprechen.
Wenn Sie beispielsweise die Klasse
DismissibleFrameLayout aus der Wear OS-UI-Bibliothek verwenden möchten, können Sie in einer Layoutdatei Folgendes angeben:
<androidx.wear.widget.DismissibleFrameLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:id="@+id/swipe_dismiss_root" >
<TextView
android:id="@+id/test_content"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:gravity="center"
android:text="Swipe the screen to dismiss me." />
</androidx.wear.widget.DismissibleFrameLayout>
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-27 (UTC)."],[],[],null,["# Build View-based UIs on Wear OS\n\nTry the Compose way \nJetpack Compose on Wear OS is the recommended UI toolkit for Wear OS. \n[Try Compose on Wear OS →](/training/wearables/compose) \n\n\n[Android Jetpack](/jetpack/androidx) includes the Wear OS UI Library.\nThe Wear OS UI library includes the following classes:\n\n- [CurvedTextView](/reference/kotlin/androidx/wear/widget/CurvedTextView): a component for easily writing text that follows the curvature of the largest circle that can be inscribed in the view.\n- [DismissibleFrameLayout](/reference/androidx/wear/widget/DismissibleFrameLayout): a layout that lets the user dismiss any view by pressing the back button or swiping on the screen from left to right. Wear OS users expect left-to-right swiping for the back action.\n- [WearableRecyclerView](/reference/androidx/wear/widget/WearableRecyclerView): a view that provides basic offsetting logic for updating child layouts using a [WearableLinearLayoutManager](/reference/androidx/wear/widget/WearableLinearLayoutManager).\n- [AmbientModeSupport](/reference/androidx/wear/ambient/AmbientModeSupport): a class used with the [AmbientModeSupport.AmbientCallbackProvider](/reference/androidx/wear/ambient/AmbientModeSupport.AmbientCallbackProvider) interface to provide support for ambient mode.\n\n\nFor a full list, read the [release notes](/jetpack/androidx/releases/wear).\n\nAdd a dependency on the Wear OS UI Library\n------------------------------------------\n\n\nTo start creating apps, create a Wear-OS-specific project. Then add the following dependencies\nto your app's `build.gradle` file: \n\n```groovy\ndependencies {\n ...\n // Standard Wear OS libraries\n implementation \"androidx.wear:wear:1.2.0\"\n // includes support for wearable specific inputs\n implementation \"androidx.wear:wear-input:1.1.0\"\n}\n```\n\nImport classes from the Wear OS UI Library package\n--------------------------------------------------\n\n\nTo use a class from the Wear OS UI Library, import it from the\n`androidx.wear.widget` package.\n\nUse the right element names in layout files\n-------------------------------------------\n\n\nIn layout files, use fully qualified names that correspond to the Wear OS UI\nLibrary.\n\n\nFor example, to use the\n[DismissibleFrameLayout](/reference/androidx/wear/widget/DismissibleFrameLayout) class from the Wear OS UI Library, you could specify\nthe following in a layout file: \n\n```xml\n\u003candroidx.wear.widget.DismissibleFrameLayout\n xmlns:android=\"http://schemas.android.com/apk/res/android\"\n xmlns:tools=\"http://schemas.android.com/tools\"\n android:layout_width=\"match_parent\"\n android:layout_height=\"match_parent\"\n android:id=\"@+id/swipe_dismiss_root\" \u003e\n\n \u003cTextView\n android:id=\"@+id/test_content\"\n android:layout_width=\"match_parent\"\n android:layout_height=\"match_parent\"\n android:gravity=\"center\"\n android:text=\"Swipe the screen to dismiss me.\" /\u003e\n\u003c/androidx.wear.widget.DismissibleFrameLayout\u003e\n```"]]
