Cómo compilar IUs basadas en View en Wear OS
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Prueba la forma de Compose
Jetpack Compose en Wear OS es el kit de herramientas de IU recomendado para Wear OS.
Android Jetpack incluye la biblioteca de la IU de Wear OS.
La biblioteca de la IU de Wear OS incluye las siguientes clases:
-
CurvedTextView
: Es un componente para escribir texto con facilidad, que sigue la curvatura del círculo más grande que se pueda grabar en la vista.
-
DismissibleFrameLayout
: Es un diseño que permite al usuario descartar cualquier vista presionando el botón Atrás o deslizando el dedo por la pantalla de izquierda a derecha.
Los usuarios de Wear OS esperan deslizar el dedo de izquierda a derecha para retroceder.
-
WearableRecyclerView
: Es una vista que proporciona lógica de desplazamiento básica para actualizar diseños secundarios a través de
WearableLinearLayoutManager
.
-
AmbientModeSupport
: Es una clase que se usa con la interfaz
AmbientModeSupport.AmbientCallbackProvider
para brindar compatibilidad con el modo ambiente.
Para obtener una lista completa, consulta las notas de la versión.
Cómo agregar una dependencia en la biblioteca de la IU de Wear OS
Para comenzar a crear apps, crea un proyecto específico para Wear OS. Agrega las siguientes dependencias al archivo build.gradle
de tu app:
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"
}
Cómo importar clases desde el paquete de la biblioteca de la IU de Wear OS
Para usar una clase de la biblioteca de la IU de Wear OS, impórtala desde el paquete androidx.wear.widget
.
Cómo utilizar los nombres correctos de los elementos en los archivos de diseño
En los archivos de diseño, usa nombres completos que correspondan a la biblioteca de la IU de Wear OS.
Por ejemplo, para usar la clase
DismissibleFrameLayout
de la biblioteca, podrías especificar lo siguiente en un archivo de diseño:
<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>
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[null,null,["Última actualización: 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```"]]