Ajouter des composants à votre projet

Avant de commencer, consultez le Guide de l'architecture des applications pour connaître les principes utiles qui s'appliquent à toutes les applications Android et obtenir des conseils sur l'utilisation simultanée de composants d'architecture.

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

Ouvrez le fichier settings.gradle et ajoutez l'indicateur google() :

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

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

Déclarer des dépendances

Ouvrez le fichier build.gradle de votre appli ou de 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 :

• Futures (disponible dans androidx.concurrent)
• Lifecycle (y compris ViewModel)
• Navigation (y compris SafeArgs)
• Paging
• Room
• WorkManager

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 Migrer vers AndroidX.

Kotlin

Les modules d'extension Kotlin sont compatibles avec plusieurs dépendances AndroidX. Le suffixe -ktx est ajouté au nom de ces modules. Par exemple :

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

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

devient

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

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.