Criar IUs baseadas em visualização no Wear OS
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Testar o Compose
O Jetpack Compose no Wear OS é o kit de ferramentas de interface recomendado para Wear OS.
O Android Jetpack inclui a biblioteca de interface do Wear OS.
A biblioteca de interface do Wear OS inclui estas classes:
Para uma lista completa, consulte as notas da versão.
Adicionar uma dependência à Biblioteca de interface do WearOS
Para começar a criar um app, crie um projeto específico do Wear OS. Em seguida, adicione as seguintes
dependências ao arquivo build.gradle
do 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"
}
Importar classes do pacote da Biblioteca de interface do Wear OS
Para usar uma classe da Biblioteca de interface do Wear OS, importe-a do
pacote androidx.wear.widget
.
Usar os nomes de elementos corretos em arquivos de layout
Nos arquivos de layout, use nomes totalmente qualificados que correspondam à Biblioteca de interface do
Wear OS.
Por exemplo, para usar a classe
DismissibleFrameLayout
da Biblioteca de interface do Wear OS, especifique o seguinte
em um arquivo de layout:
<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>
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[null,null,["Última atualização 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```"]]