Premiers pas

Découvrez comment préparer votre environnement de développement à l'utilisation des données Bibliothèque de liaisons, y compris la prise en charge du code de liaison de données dans Android Studio.

La bibliothèque Data Binding offre à la fois flexibilité et large la compatibilité : il s'agit d'une bibliothèque de support que vous pouvez utiliser avec des appareils équipés d'Android 4.0 (niveau d'API 14) ou version ultérieure.

Nous vous recommandons d'utiliser la dernière version du plug-in Android Gradle dans votre projet. Toutefois, la liaison de données est compatible avec les versions 1.5.0 et ultérieures. Pour plus informations, découvrez comment mettre à jour Android Gradle plug-in.

Environnement de compilation

Pour commencer à utiliser la liaison de données, téléchargez la bibliothèque depuis le Centre d'aide d'Android SDK dans Android SDK Manager. Pour en savoir plus, consultez la section Mettre à jour le IDE et SDK Tools.

Pour configurer votre application afin qu'elle utilise la liaison de données, activez l'option de compilation dataBinding dans le fichier build.gradle du module de l'application, comme illustré ci-dessous Exemple:

android {
    ...
    buildFeatures {
        dataBinding true
    }
}

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

Android Studio est compatible avec de nombreuses fonctionnalités de modification du code de liaison de données. Pour exemple, il prend en charge les fonctionnalités suivantes pour les expressions de liaison de données:

  • Coloration syntaxique
  • Signalement des erreurs de syntaxe du langage d'expression
  • Complétion de code XML
  • Références, y compris navigation, comme accéder à une déclaration. documentation rapide

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

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

Si vous devez afficher une valeur par défaut uniquement 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écrites dans la documentation de référence sur les attributs des outils.

Ressources supplémentaires

Pour en savoir plus sur la liaison de données, consultez des ressources supplémentaires.