Ajouter des composants à votre projet

Signalez les problèmes pour que nous puissions corriger les bugs.

Avant de commencer, nous vous recommandons de lire le Guide de l'architecture des applications sur les composants d'architecture. Celui-ci comprend quelques principes utiles qui s'appliquent à toutes les applications Android et montre comment utiliser les composants d'architecture ensemble.

Les composants d'architecture sont disponibles dans le dépôt Maven de Google. Pour les utiliser, vous devez ajouter le dépôt à votre projet.

Ouvrez le fichier settings.gradle et ajoutez le dépôt google() comme indiqué ci-dessous :

Groovy

dependencyResolutionManagement {
   ...
    repositories {
        google()
        jcenter()
    }
}

Kotlin

dependencyResolutionManagement {
    ...
    repositories {
        google()
        jcenter()
    }
}

Déclarer des dépendances

Ouvrez le fichier build.gradle de votre application ou votre module, puis ajoutez les artefacts dont vous avez besoin en tant que dépendances. Vous pouvez ajouter des dépendances pour tous les composants d'architecture ou choisir un sous-ensemble.

Pour savoir comment déclarer des dépendances pour chaque composant d'architecture, consultez les notes de version :

Consultez les versions AndroidX pour obtenir les numéros de version les plus récents pour chaque composant.

Pour en savoir plus sur la refactorisation AndroidX et son impact sur ces packages de classe et ID de module, consultez la documentation sur la refactorisation d'AndroidX.

Kotlin

Les modules d'extension Kotlin sont compatibles avec plusieurs dépendances AndroidX. Le nom de ces modules comporte le suffixe « -ktx ». Par exemple :

Groovy

implementation "androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version"

Kotlin

implementation("androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version")

devient

Groovy

implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version"

Kotlin

implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version")

Vous trouverez plus d'informations, y compris la documentation sur les extensions Kotlin, dans la documentation KTX.

Remarque : Pour les applications basées sur Kotlin, assurez-vous d'utiliser kapt au lieu d'annotationProcessor. Vous devez également ajouter le plug-in kotlin-kapt.