Biblioteca de vinculación de datos   Parte de Android Jetpack

La biblioteca de vinculación de datos es una biblioteca de compatibilidad que permite vincular los componentes de la IU de tus diseños a las fuentes de datos de tu app usando un formato declarativo en lugar de la programación.

Los diseños a menudo se definen en actividades con código que llama a los métodos de framework de la IU. Por ejemplo, el siguiente código llama a findViewById() para encontrar un widget TextView y vincularlo a la propiedad userName de la variable viewModel:

    findViewById<TextView>(R.id.sample_text).apply {
        text = viewModel.userName
    }

    

    TextView textView = findViewById(R.id.sample_text);
    textView.setText(viewModel.getUserName());

    

El siguiente ejemplo muestra cómo usar la biblioteca de vinculación de datos para asignar texto al widget directamente en el archivo de diseño. De esta manera, no es necesario llamar a ninguno de los códigos Java que se muestran arriba. Observa el uso de la sintaxis @{} en la expresión de asignación:

<TextView
        android:text="@{viewmodel.userName}" />
    

La vinculación de componentes en el archivo de diseño permite quitar varias llamadas al framework de la IU en las actividades, que resultan más sencillas y fáciles de mantener. Esto también puede mejorar el rendimiento de la app y ayudar a evitar pérdidas de memoria y excepciones de puntero nulo.

Uso de la biblioteca de vinculación de datos

Usa las siguientes páginas para aprender a usar la biblioteca de vinculación de datos en tus apps de Android.

Cómo comenzar

Obtén información sobre cómo preparar tu entorno de desarrollo para trabajar con la biblioteca de vinculación de datos, incluida la compatibilidad con el código de vinculación de datos en Android Studio.

Diseños y expresiones vinculantes

<layout xmlns:android="http://schemas.android.com/apk/res/android"
            xmlns:app="http://schemas.android.com/apk/res-auto">
        <data>
            <variable
                name="viewmodel"
                type="com.myapp.data.ViewModel" />
        </data>
        <ConstraintLayout... /> <!-- UI layout's root element -->
    </layout>
    

Cómo trabajar con objetos de datos observables

La biblioteca de vinculación de datos proporciona clases y métodos para observar fácilmente los datos en busca de cambios. No necesitas preocuparte por actualizar la IU cuando cambie la fuente de datos subyacente. Puedes hacer que tus variables o sus propiedades sean observables. La biblioteca te permite hacer que objetos, campos o colecciones sean observables.

Clases de vinculación generadas

La biblioteca de vinculación de datos genera clases de vinculación que se usan para acceder a las variables y vistas del diseño. Esta página muestra cómo usar y personalizar las clases de vinculación generadas.

Adaptadores de vinculación

Para cada expresión de diseño, hay un adaptador de vinculación que hace las llamadas de framework requeridas para establecer las propiedades o los objetos de escucha correspondientes. Por ejemplo, el adaptador de vinculación puede llamar al método setText() para establecer la propiedad de texto, o bien al método setOnClickListener() para agregar un objeto de escucha en el evento de clic. Los adaptadores de vinculación más comunes, como los de la propiedad android:text que se usan en los ejemplos de esta página, están disponibles para su uso en el paquete android.databinding.adapters. Para ver la lista de los adaptadores de vinculación comunes, consulta adaptadores. También puedes crear adaptadores personalizados, como se muestra en el siguiente ejemplo:

    @BindingAdapter("app:goneUnless")
    fun goneUnless(view: View, visible: Boolean) {
        view.visibility = if (visible) View.VISIBLE else View.GONE
    }

    

    @BindingAdapter("app:goneUnless")
    public static void goneUnless(View view, Boolean visible) {
        view.visibility = visible ? View.VISIBLE : View.GONE;
    }

    

Cómo vincular vistas de diseño con componentes de arquitectura

La biblioteca de asistencia de Android incluye los componentes de arquitectura, que puedes usar para diseñar apps que sean sólidas, aptas para pruebas y mantenibles. También puedes usar estos componentes con la biblioteca de vinculación de datos para simplificar aún más el desarrollo de la IU.

Vinculación de datos en dos direcciones

La biblioteca de vinculación de datos admite la vinculación de datos bidireccional. La notación utilizada para este tipo de vinculación admite la capacidad de recibir cambios de datos en una propiedad y, al mismo tiempo, escuchar las actualizaciones de los usuarios a esa propiedad.