Le librerie Jetpack vengono fornite separatamente dal sistema operativo Android, pertanto gli aggiornamenti delle librerie possono essere eseguiti in modo indipendente e con maggiore frequenza.
Le librerie seguono un rigoroso controllo delle versioni semantico per la compatibilità binaria con una sequenza di inter-versioni aggiunta di revisioni pre-release.
Una stringa di versione (come 1.0.1-beta02
) contiene tre numeri che rappresentano i livelli di correzione: maggiore, minore e correzione di bug.
Le versioni pre-release hanno anche un suffisso che specifica la fase di pre-release
(alpha, beta, candidata alla release) e il numero di revisione (01, 02 e così via).
Tieni presente che le librerie androidx
sono consigliate, ma non obbligatorie, per preservare la compatibilità del codice sorgente nelle versioni secondarie. Il motivo per cui un aggiornamento della versione principale potrebbe forzare la migrazione esplicita di tutti gli artefatti che dipendono dalla versione principale precedente, il che causerebbe l'interruzione del flusso di lavoro degli sviluppatori.
Ogni versione di una raccolta passa attraverso tre fasi di pre-release per arrivare a una release stabile. I criteri per ogni fase di pre-lancio sono:
Alfa
- Le release alpha sono stabili dal punto di vista funzionale, ma potrebbero non essere complete di tutte le funzionalità.
- Mentre una release è in versione alpha, le API possono essere aggiunte, rimosse o modificate.
Versione beta
- Le release beta sono funzionalmente stabili e hanno una superficie API completa di tutte le funzionalità.
- Sono pronte per l'uso in produzione, ma potrebbero contenere bug.
- Una release beta non può utilizzare funzionalità di compilazione sperimentali
(come
@UseExperimental
). - Le dipendenze da altre librerie devono essere versioni beta, rc o stabili. Non sono consentite dipendenze alpha.
Candidato per l'uscita
- Una release candidata è una potenziale release stabile.
- Potrebbe contenere correzioni critiche dell'ultimo minuto.
- La sua superficie API è definitiva.
- Le dipendenze da altre librerie devono essere solo versioni rc o stabili.
Una libreria può avere più versioni contemporaneamente. Ogni versione ha una fase di rilascio
diversa. Ad esempio, anche se la release stabile di
androidx.activity
potrebbe essere 1.0.0
, potrebbero esserci anche una release 1.1.0-beta02
e una release 2.0.0-alpha01
.
Utilizza questa pagina per informazioni sugli ultimi aggiornamenti delle librerie.
La pagina delle note di rilascio recenti di AndroidX elenca le librerie che sono state modificate di recente. Il repository Maven di Google mostra la cronologia delle versioni completa.
Utilizza la tabella che segue per visualizzare le versioni stabili e in anteprima più recenti di ogni libreria AndroidX. I link in ogni riga consentono di accedere alle note di rilascio della raccolta. Nelle note di rilascio troverai:
- La cronologia cronologica di tutte le uscite.
- Uno snippet di codice con le dichiarazioni di dipendenza Gradle predefinite per utilizzare gli artefatti.
- Link alle pagine di riferimento di Kotlin e Java relative ai pacchetti di ciascun artefatto.
Librerie Jetpack
Alcune librerie AndroidX, come la fotocamera, hanno diversi elementi che vengono gestiti separatamente. Queste librerie sono contrassegnate da un asterisco (*). Consulta le note di rilascio per visualizzare gli aggiornamenti della versione per tutti gli artefatti.