Premiers pas

Découvrez comment préparer votre environnement de développement à utiliser la bibliothèque Data Binding, y compris la prise en charge du code de liaison de données dans Android Studio.

La bibliothèque Data Binding offre une flexibilité et une compatibilité étendue. Il s'agit d'une bibliothèque Support qui peut être utilisée avec des appareils équipés d'Android 4.0 (niveau d'API 14) ou version ultérieure.

Nous vous recommandons d'utiliser le dernier plug-in Android Gradle dans votre projet. Cependant, la liaison de données est compatible avec les versions 1.5.0 et ultérieures. Pour en savoir plus, découvrez comment mettre à jour le plug-in Android Gradle.

Environnement de compilation

Pour commencer à utiliser la liaison de données, téléchargez la bibliothèque à partir du dépôt Support d'Android SDK Manager. Pour en savoir plus, consultez Mettre à jour l'IDE et SDK Tools.

Pour configurer votre application afin d'utiliser la liaison de données, activez l'option de compilation dataBinding dans le fichier build.gradle du module de l'application, comme illustré dans l'exemple suivant:

android {
    ...
    buildFeatures {
        dataBinding true
    }
}

Compatibilité d'Android Studio avec la liaison de données

Android Studio est compatible avec de nombreuses fonctionnalités d'édition du code de liaison de données. Par exemple, il accepte les fonctionnalités suivantes pour les expressions de liaison de données:

• Mise en évidence de la syntaxe
• Signalement des erreurs de syntaxe du langage d'expression
• Saisie automatique de code XML
• Références, y compris la navigation (par exemple, accéder à une déclaration) et documentation rapide

Le volet Aperçu de l'éditeur de mise en page affiche la valeur par défaut des expressions de liaison de données, le cas échéant. Par exemple, le volet Preview (Aperçu) affiche la valeur my_default sur le widget TextView déclaré dans l'exemple suivant:

<TextView android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="@{user.firstName, default=my_default}"/>

Si vous ne devez afficher une valeur par défaut que pendant la phase de conception de votre projet, vous pouvez utiliser des attributs tools au lieu des valeurs d'expression par défaut, comme décrit dans la documentation de référence sur les attributs des outils.