Les bibliothèques Jetpack sont fournies indépendamment de l'OS Android, ce qui permet de les mettre à jour de manière indépendante et plus fréquemment.
Les bibliothèques respectent une gestion sémantique des versions stricte qui permet d'assurer la compatibilité des binaires avec une séquence de révisions préliminaires entre les différentes versions.
Une chaîne de version (1.0.1-beta02
, par exemple) contient trois chiffres représentant les niveaux majeur, mineur et de correction de bug.
Les versions préliminaires comportent également un suffixe qui spécifie l'étape préliminaire (alpha, bêta, version admissible) et le numéro de révision (01, 02, etc.).
Remarque : Les bibliothèques androidx
sont recommandées pour préserver la compatibilité du source entre les différentes versions mineures, mais pas obligatoires. En effet, si une mise à jour de version majeure était appliquée, tous les artefacts qui dépendent de la version majeure précédente seraient migrés de manière explicite, ce qui perturberait le workflow de développement.
Chaque version d'une bibliothèque passe par trois étapes préliminaires avant de devenir une version stable. Voici les critères applicables à chaque étape préliminaire :
Alpha
- Les versions alpha sont stables d'un point de vue fonctionnel, mais pas nécessairement complètes.
- Des API peuvent encore être ajoutées, supprimées ou modifiées.
Bêta
- Les versions bêta sont stables d'un point de vue fonctionnel et leur surface d'API contient toutes les fonctionnalités.
- Elles sont prêtes pour la production, mais peuvent contenir des bugs.
- Une version bêta ne peut pas utiliser les fonctionnalités de compilation expérimentales (telles que
@UseExperimental
). - Les dépendances aux autres bibliothèques doivent être en version bêta, admissible ou stable. Aucune dépendance alpha n'est autorisée.
Version admissible
- Une version admissible est une version stable potentielle.
- Elle peut contenir des correctifs de dernière minute critiques.
- Sa surface d'API est définitive.
- Les dépendances aux autres bibliothèques doivent être en version admissible ou stable uniquement.
Une bibliothèque peut avoir plusieurs versions en même temps, chacune correspondant à une étape de publication différente. Par exemple, androidx.activity
peut avoir une version stable 1.0.0
, plus deux autres versions : 1.1.0-beta02
et 2.0.0-alpha01
.
Cette page détaille les dernières modifications apportées aux bibliothèques.
La page Notes de version récentes d'AndroidX indique les bibliothèques récemment modifiées. Le dépôt Maven de Google présente l'historique complet des versions.
Le tableau ci-dessous indique les versions stables et preview les plus récentes pour chaque bibliothèque AndroidX. Les liens figurant sur chaque ligne renvoient aux notes de version de la bibliothèque. Vous y trouverez les informations suivantes :
- L'historique de l'ensemble des versions, par ordre chronologique
- Un extrait de code avec les déclarations de dépendance Gradle par défaut pour utiliser les artefacts
- Des liens vers la documentation de référence Kotlin et Java des packages pour chaque artefact
Bibliothèques Jetpack
Certaines bibliothèques AndroidX, comme l'appareil photo, possèdent plusieurs artefacts qui sont gérés séparément. Ces bibliothèques sont signalées par un astérisque (*). Consultez les notes de version pour connaître les mises à jour de versions de tous les artefacts.
(*) Cette bibliothèque comporte plusieurs artefacts. Pour en savoir plus, consultez les notes de version.
Dernière mise à jour: 7 août 2024