Présentation d'AndroidX

L'espace de noms androidx comprend les bibliothèques Android Jetpack. Tout comme la bibliothèque Support, les bibliothèques dans l'espace de noms androidx sont fournies séparément de la plate-forme Android et assurent la rétrocompatibilité entre les versions d'Android.

AndroidX est une amélioration majeure de la bibliothèque Support Android d'origine, dont la maintenance n'est plus assurée. Les formules androidx remplacent complètement la bibliothèque Support en offrant des fonctionnalités identiques et de nouvelles bibliothèques.

En outre, AndroidX offre les fonctionnalités suivantes :

  • Tous les packages d'AndroidX se trouvent dans un espace de noms cohérent commençant par la chaîne androidx. Les formules de la bibliothèque Support ont été mappées aux packages androidx.* correspondants. Pour voir le mappage complet de toutes les anciennes classes et les artefacts de build avec les nouveaux, consultez la page Refactorisation de package.

  • Contrairement à la bibliothèque Support, les formules androidx sont gérées et mises à jour séparément. Les packages androidx utilisent une gestion sémantique des versions stricte, commençant par la version 1.0.0. Vous pouvez mettre à jour les bibliothèques AndroidX de votre projet séparément.

  • La version 28.0.0 est la dernière version de la bibliothèque Support. Plus aucune version de la bibliothèque android.support ne sera publiée. Toutes les nouvelles fonctionnalités seront développées dans l'espace de noms androidx.

Utiliser des bibliothèques androidx dans votre projet

La dernière version d'AGP est compatible avec l'utilisation des bibliothèques androidx par défaut. Consultez Effectuer une migration vers AndroidX pour découvrir comment migrer effectuer la migration d'un projet existant.

Pour les projets qui n'ont pas été migrés ou qui comportent des dépendances héritées, AGP fournit les indicateurs suivants qui peuvent être définis dans le fichier gradle.properties de votre projet.

  • android.useAndroidX: "True" par défaut dans le plug-in Android Gradle 9.0.0 et versions ultérieures, "False" dans les versions antérieures à 9.0.0. Lorsque cet indicateur est défini sur true, le plug-in Android utilise la bibliothèque AndroidX appropriée au lieu d'une bibliothèque Support. La possibilité de définir cet indicateur sur false devrait être supprimée dans AGP 10.
  • android.enableJetifier: lorsque cet indicateur est défini sur true, le plug-in Android migre automatiquement les bibliothèques tierces existantes pour utiliser les dépendances AndroidX en réécrivant leurs binaires. L'indicateur est false par défaut s'il n'est pas spécifié et devrait être supprimé dans AGP 10, car la migration des bibliothèques publiées est généralement terminée.

Documentation de référence de l'API

Tous les packages et classes de l'espace de noms androidx sont disponibles dans la section de référence AndroidX.

Autres ressources

Pour en savoir plus sur les composants, consultez la page d'accueil de Jetpack home page. Pour en savoir plus sur la refactorisation de package de la bibliothèque Support vers androidx, consultez cet article de blog.