Cómo usar la biblioteca de la IU de Wear

Android Jetpack admite interfaces de usuario coherentes y optimizadas en todas las apps. Android Jetpack incluye la biblioteca de la UI de Wear, que contiene muchos de los componentes de IU preferidos para tus apps de Wear OS.

La biblioteca de la IU de Wear incluye las siguientes clases, entre otras. Algunas tienen nombres similares a las clases obsoletas relacionadas que se incluyen en la Biblioteca de compatibilidad de dispositivos wearables y ofrecen varios beneficios con respecto a ellas:

• BoxInsetLayout. Es un diseño que aplica inserciones para pantallas redondas.
• SwipeDismissFrameLayout. Es un diseño que permite al usuario descartar cualquier vista deslizando la pantalla de izquierda a derecha.
• WearableRecyclerView. Es una vista que proporciona un diseño curvo, como el diseño utilizado para el selector principal de aplicaciones para Wear.
• AmbientModeSupport. Una clase que se usa con la interfaz AmbientModeSupport.AmbientCallbackProvider para brindar compatibilidad con el modo ambiente.

También consulta Paneles laterales de acción y navegación en la biblioteca de la IU de Wear.

Cómo agregar una dependencia en la biblioteca de la IU de Wear

Para usar la biblioteca de la IU de Wear, agrega la siguiente dependencia en el archivo build.gradle de tu módulo de Wear:

    dependencies {
        ...
        compile 'androidx.wear:wear:1.0.0'
    }
    

Cómo importar clases desde el paquete de la biblioteca de la IU de Wear

Cuando uses una clase de la biblioteca de la IU de Wear, importa esa clase desde el paquete androidx.wear.widget. Consulta el Ejemplo de cómo usar una clase de biblioteca.

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 (en lugar de a la biblioteca de compatibilidad con dispositivos wearable).

Por ejemplo, para usar la clase SwipeDismissFrameLayout de la biblioteca de la IU de Wear, podrías especificar lo siguiente en un archivo de diseño:

    <androidx.wear.widget.SwipeDismissFrameLayout
        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.SwipeDismissFrameLayout>
    

Ejemplo de cómo usar una clase de biblioteca de la IU de Wear

Las clases en la biblioteca de IU de Wear tienen la misma funcionalidad o una similar a la de la biblioteca de compatibilidad con dispositivos wearables. Algunos nombres de clase, método y atributo se actualizan para mejorar la coherencia con la biblioteca de compatibilidad de Android.

Por ejemplo, una actividad que utiliza la clase WearableRecyclerView de la Biblioteca de compatibilidad con dispositivos wearables podría incluir el siguiente código:

    import androidx.wear.widget.WearableRecyclerView
    ...
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.wearable_recycler_view_basic)
        findViewById<WearableRecyclerView>(R.id.wrv).apply {
            layoutManager = ChildLayoutManager()
            adapter = TestAdapter()
        }
    }
    

    import androidx.wearable.view.WearableRecyclerView;
    ...
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.wearable_recycler_view_basic);
        WearableRecyclerView wrv = findViewById(R.id.wrv);
        wrv.setLayoutManager(new ChildLayoutManager());
        wrv.setAdapter(new TestAdapter());
    }
    

De manera similar, una actividad que usa la clase WearableRecyclerView de la biblioteca de la IU de Wear podría incluir el siguiente código. Las diferencias con el código anterior están en negrita:

    import androidx.wear.widget.WearableRecyclerView
    ...
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.wearable_recycler_view_basic)
        findViewById<WearableRecyclerView>(R.id.wrv).apply {
            layoutManager = WearableLinearLayoutManager(this@MainActivity)
            adapter = TestAdapter()
        }
    }
    

    import androidx.wear.widget.WearableRecyclerView;
    ...
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.wearable_recycler_view_basic);
        WearableRecyclerView wrv = findViewById(R.id.wrv);
        wrv.setLayoutManager(new WearableLinearLayoutManager(this));
        wrv.setAdapter(new TestAdapter());
    }
    

Paneles laterales de acción y navegación en la biblioteca de IU de Wear

La biblioteca de la IU de Wear contiene componentes para paneles laterales de acción y navegación.

Si deseas obtener información adicional, consulta Navegación y acciones para Wear.

Reemplazos para clases obsoletas

La tabla que se encuentra a continuación contiene reemplazos para las clases obsoletas de la Biblioteca de compatibilidad con dispositivos wearables en la biblioteca de la IU de Wear y en otros lugares.