Le librerie Jetpack vengono fornite separatamente dal sistema operativo Android, quindi gli aggiornamenti le librerie possono essere eseguite in modo indipendente e con maggiore frequenza.
Le librerie seguono il controllo delle versioni semantiche rigorose per la compatibilità binaria con una sequenza inter-versione di revisioni di pre-release.
Una stringa di versione (ad esempio 1.0.1-beta02
) contiene tre numeri che rappresentano i livelli principale, secondario e di correzione di bug.
Le versioni di pre-release hanno anche un suffisso che specifica la fase di pre-release (alpha, beta, release candidate) 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 tra le versioni minori. Il motivo per cui è stato eseguito un aggiornamento della versione principale forza la migrazione esplicita di tutti gli artefatti che dipendono dalla versione principale precedente, con conseguente interruzione del flusso di lavoro degli sviluppatori.
Ogni versione di una raccolta attraversa tre fasi di pre-release in arrivo diventando una release stabile. I criteri per ogni fase di pre-release sono:
Alpha
- Le release alpha sono funzionalmente stabili, ma potrebbero non essere complete di tutte le funzionalità.
- Mentre una release è in versione alpha, le API possono essere aggiunte, rimosse o modificate.
Beta
- Le release beta sono stabili dal punto di vista funzionale e hanno una superficie API completa di funzionalità.
- Sono pronte per l'uso in produzione, ma possono contenere bug.
- Una versione beta non può utilizzare le funzionalità sperimentali di compilazione
(ad esempio
@UseExperimental
). - Le dipendenze da altre librerie devono essere beta, rc o stabili e versioni successive. Non sono consentite dipendenze alpha.
Candidato per la release (RC)
- Un candidato per la release è una release stabile potenziale.
- 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 un
fasi di rilascio diverse. Ad esempio, mentre la release stabile di
androidx.activity
potrebbe essere 1.0.0
, potrebbe essere disponibile anche una release 1.1.0-beta02
e una 2.0.0-alpha01
.
Utilizza questa pagina per scoprire gli ultimi aggiornamenti alle librerie.
La pagina delle note sulla versione recente di AndroidX elenca le librerie che sono state modificate di recente. Il repository Maven di Google mostra la cronologia completa delle versioni.
Usa la tabella che segue per visualizzare le versioni stabili e in anteprima più recenti di ogni nella libreria AndroidX. I link in ogni riga rimandano alle note di rilascio della raccolta. Nelle note di rilascio troverai:
- La cronologia cronologica di tutte le release.
- Uno snippet di codice con le dichiarazioni di dipendenza Gradle predefinite per utilizzare gli elementi.
- Link alle pagine di riferimento di Kotlin e Java per i pacchetti in ogni artefatto.
Biblioteche jetpack
Alcune librerie AndroidX, come la fotocamera, hanno più 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 elementi.