Annotazione

  
Esponi metadati che aiutano gli strumenti e gli altri sviluppatori a comprendere il codice della tua app.

Questa tabella elenca tutti gli elementi nel gruppo androidx.annotation.

Elemento Release stabile Candidato per la release Versione beta Versione alpha
annotazione 1.9.1 - - -
annotation-experimental 1.4.1 - 1.5.0-beta01 -
Questa libreria è stata aggiornata l'ultima volta il 9 aprile 2025

Dichiarazione delle dipendenze

Per aggiungere una dipendenza da Annotation, devi aggiungere il repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli elementi necessari nel file build.gradle per la tua app o il tuo modulo:

Groovy

dependencies {
    implementation "androidx.annotation:annotation:1.9.1"
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation "androidx.annotation:annotation-experimental:1.4.1"
}

Kotlin

dependencies {
    implementation("androidx.annotation:annotation:1.9.1")
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation("androidx.annotation:annotation-experimental:1.4.1")
}

Per ulteriori informazioni sulle dipendenze, consulta Aggiungere dipendenze di compilazione.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di crearne uno nuovo, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Creare un nuovo problema

Per ulteriori informazioni, consulta la documentazione del Tracker dei problemi.

Versione 1.9

Versione 1.9.1

30 ottobre 2024

androidx.annotation:annotation-*:1.9.1 viene rilasciato. La versione 1.9.1 contiene questi commit.

Correzioni di bug

  • È stata aggiunta la piattaforma di destinazione JS. (I2310b)
  • Aggiornamento della versione di Kotlin alla 1.9 (I1a14c)

Versione 1.9.0

16 ottobre 2024

androidx.annotation:annotation-*:1.9.0 viene rilasciato. La versione 1.9.0 contiene questi commit.

Modifiche importanti dalla versione 1.8.0

  • È stato aggiunto il supporto per i seguenti target Kotlin Multiplatform: watchosDeviceArm64, mingwX64, linuxArm64.

Versione 1.9.0-rc01

2 ottobre 2024

androidx.annotation:annotation-*:1.9.0-rc01 viene rilasciato. La versione 1.9.0-rc01 non contiene modifiche rispetto alla versione beta precedente.

Versione 1.9.0-beta01

18 settembre 2024

androidx.annotation:annotation-*:1.9.0-beta01 viene rilasciato. La versione 1.9.0-beta01 contiene questi commit.

Modifiche all'API

  • Aggiunta del supporto per la destinazione della piattaforma watchosDeviceArm64 (I1cc04, b/364652024)

Versione 1.9.0-alpha03

4 settembre 2024

androidx.annotation:annotation-*:1.9.0-alpha03 viene rilasciato. La versione 1.9.0-alpha03 non contiene modifiche rispetto alla versione alpha precedente.

Versione 1.9.0-alpha02

21 agosto 2024

androidx.annotation:annotation-*:1.9.0-alpha02 viene rilasciato. La versione 1.9.0-alpha02 contiene questi commit.

Nuove funzionalità

Versione 1.9.0-alpha01

26 giugno 2024

androidx.annotation:annotation-*:1.9.0-alpha01 viene rilasciato. La versione 1.9.0-alpha01 contiene questi commit.

Contributo esterno

  • Aggiunta del supporto per il target multipiattaforma linuxArm64 (grazie a Jake Wharton)

Versione 1.8

Versione 1.8.2

7 agosto 2024

androidx.annotation:annotation-*:1.8.2 viene rilasciato. La versione 1.8.2 contiene questi commit.

Correzioni di bug

Versione 1.8.1

24 luglio 2024

androidx.annotation:annotation-*:1.8.1 viene rilasciato. La versione 1.8.1 contiene questi commit.

Correzioni di bug

  • Sono inclusi target Kotlin Multiplatform aggiuntivi: watchos, tvos.

Versione 1.8.0

14 maggio 2024

androidx.annotation:annotation-*:1.8.0 viene rilasciato. La versione 1.8.0 contiene questi commit.

Modifiche importanti dalla versione 1.7.0

  • È stata aggiunta l'annotazione @ReplaceWith per esprimere le sostituzioni per le API deprecate
  • L'annotazione @MainThread è stata spostata nel set di origini comuni.

Versione 1.8.0-rc01

1° maggio 2024

androidx.annotation:annotation-*:1.8.0-rc01 viene rilasciato. La versione 1.8.0-rc01 non contiene modifiche rispetto alla release beta precedente.

Versione 1.8.0-beta02

17 aprile 2024

androidx.annotation:annotation-*:1.8.0-beta02 viene rilasciato. La versione 1.8.0-beta02 non contiene modifiche rispetto alla release precedente.

Versione 1.8.0-beta01

3 aprile 2024

androidx.annotation:annotation-*:1.8.0-beta01 viene rilasciato. La versione 1.8.0-beta01 contiene questi commit.

Nuove funzionalità

  • L'annotazione ReplaceWith è ora stabile per l'API, ma il controllo lint associato con la correzione automatica non è ancora stato implementato

Versione 1.8.0-alpha02

20 marzo 2024

androidx.annotation:annotation-*:1.8.0-alpha02 viene rilasciato senza modifiche significative. La versione 1.8.0-alpha02 contiene questi commit.

Versione 1.8.0-alpha01

21 febbraio 2024

androidx.annotation:annotation-*:1.8.0-alpha01 viene rilasciato. La versione 1.8.0-alpha01 contiene questi commit.

Modifiche all'API

  • È stata aggiunta l'annotazione @ReplaceWith per esprimere le sostituzioni per le API obsolete. (I38db3, b/322373864)

Contributi esterni

  • Grazie a Ivan Matkov per aver spostato l'annotazione @MainThread nel set di origine comune. (6f228c)

Versione 1.7

Versione 1.7.1

13 dicembre 2023

androidx.annotation:annotation-*:1.7.1 viene rilasciato. La versione 1.7.1 contiene questi commit.

Correzioni di bug

  • Utilizza l'ambito compile quando inserisci la dipendenza dalla piattaforma predefinita. (I4958f)

Versione 1.7.0

6 settembre 2023

androidx.annotation:annotation-*:1.7.0 viene rilasciato. La versione 1.7.0 contiene questi commit.

Modifiche importanti dalla versione 1.6.0

  • Sono inclusi gli elementi Kotlin Multiplatform che hanno come target le piattaforme iOS, Linux e macOS.
  • Ora puoi utilizzare le annotazioni nei progetti KMM. Tieni presente che le destinazioni non Android di Annotazioni sono ancora sperimentali, ma abbiamo deciso di unire le versioni per semplificare la loro prova da parte degli sviluppatori. Nello specifico, alcune annotazioni potrebbero passare dal codice comune a quello specifico della piattaforma durante lo sviluppo alpha, man mano che finalizziamo i confini.

Versione 1.7.0-rc01

23 agosto 2023

androidx.annotation:annotation-*:1.7.0-rc01 viene rilasciato. La versione 1.7.0-rc01 contiene questi commit.

Questa release non contiene modifiche rispetto alla versione beta precedente.

Versione 1.7.0-beta01

9 agosto 2023

androidx.annotation:annotation-*:1.7.0-beta01 viene rilasciato. La versione 1.7.0-beta01 contiene questi commit.

Nuove funzionalità

  • API stabilizzate per la release

Versione 1.7.0-alpha03

26 luglio 2023

androidx.annotation:annotation-*:1.7.0-alpha03 viene rilasciato. La versione 1.7.0-alpha03 contiene questi commit.

Correzioni di bug

  • La pubblicazione del file POM Maven ora include l'elemento artefatto multipiattaforma per JVM predefinito come dipendenza

Versione 1.7.0-alpha02

24 marzo 2023

androidx.annotation:annotation-*:1.7.0-alpha02 viene rilasciato.

Correzioni di bug

  • Sono stati rimossi i vincoli di dipendenza dagli elementi Maven per aggirare un problema di compilazione nei target Kotlin Native (b/274786186, KT-57531).

Versione 1.7.0-alpha01

22 marzo 2023

androidx.annotation:annotation-*:1.7.0-alpha01 viene rilasciato. La versione 1.7.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Sono inclusi gli elementi Kotlin Multiplatform che hanno come target le piattaforme iOS, Linux e macOS.
  • Ora puoi utilizzare le annotazioni nei progetti KMM. Tieni presente che le destinazioni non Android di Annotazioni sono ancora sperimentali, ma abbiamo deciso di unire le versioni per semplificare la loro prova da parte degli sviluppatori. Nello specifico, alcune annotazioni potrebbero passare dal codice comune a quello specifico della piattaforma durante lo sviluppo alpha, man mano che finalizziamo i confini.

Versione 1.6

Versione 1.6.0

22 febbraio 2023

androidx.annotation:annotation:1.6.0 e androidx.annotation:annotation-jvm:1.6.0 vengono rilasciati. La versione 1.6.0 contiene questi commit.

Modifiche importanti dalla versione 1.5.0

  • Aggiunge un'annotazione @RequiresExtension per indicare che un'API richiede una determinata versione di un determinato SDK di estensione (I5e4fe)
  • Libreria di annotazioni convertita per la compilazione utilizzando la toolchain Kotlin Multiplatform (I3be8d)

Versione 1.6.0-rc01

8 febbraio 2023

androidx.annotation:annotation:1.6.0-rc01 e androidx.annotation:annotation-jvm:1.6.0-rc01 vengono rilasciati. La versione 1.6.0-rc01 contiene questi commit.

  • L'annotazione è stata stabilizzata per la release candidate 1.6.0-rc01.

Versione 1.6.0-beta01

25 gennaio 2023

androidx.annotation:annotation:1.6.0-beta01 e androidx.annotation:annotation-jvm:1.6.0-beta01 vengono rilasciati senza modifiche rispetto a 1.6.0-alpha01.

Versione 1.6.0-alpha01

11 gennaio 2023

androidx.annotation:annotation-*:1.6.0-alpha01 viene rilasciato. La versione 1.6.0-alpha01 contiene questi commit.

Versione 1.6.0-dev01

8 febbraio 2023

androidx.annotation:annotation-*:1.6.0-dev01 viene rilasciato. La versione 1.6.0-dev01 contiene questi commit.

  • L'annotazione ha attivato Kotlin multipiattaforma per la versione di anteprima per sviluppatori 1.6.0-dev01.

Nuove funzionalità

  • Aggiunge un'annotazione @RequiresExtension per indicare che un'API richiede una determinata versione di un determinato SDK di estensione. (I5e4fe)
  • Libreria di annotazioni convertita per la compilazione utilizzando la toolchain Kotlin Multiplatform (I3be8d)

Versione 1.5.0

Versione 1.5.0

21 settembre 2022

androidx.annotation:annotation:1.5.0 viene rilasciato. La versione 1.5.0 contiene questi commit.

Modifiche importanti dalla versione 1.4.0

  • È stata eseguita la migrazione completa della libreria di annotazioni alle origini Kotlin, con il risultato del supporto di siti di utilizzo target specifici di Kotlin e di altre funzionalità di annotazione compatibili con Kotlin.

Versione 1.5.0-rc01

7 settembre 2022

androidx.annotation:annotation:1.5.0-rc01 viene rilasciato. La versione 1.5.0-rc01 contiene questi commit.

  • Nessuna modifica rispetto alla release beta 1.5.0 precedente.

Versione 1.5.0-beta01

24 agosto 2022

androidx.annotation:annotation:1.5.0-beta01 viene rilasciato. La versione 1.5.0-beta01 contiene questi commit.

  • Nessuna modifica rispetto alla release precedente. L'interfaccia API è stata bloccata per la versione beta.

Versione 1.5.0-alpha02

10 agosto 2022

androidx.annotation:annotation:1.5.0-alpha02 viene rilasciato. La versione 1.5.0-alpha02 contiene questi commit.

  • Nessuna modifica rispetto alla release alpha precedente.

Versione 1.5.0-alpha01

27 luglio 2022

androidx.annotation:annotation:1.5.0-alpha01 viene rilasciato. La versione 1.5.0-alpha01 contiene questi commit.

Nuove funzionalità

  • È stata eseguita la migrazione completa della libreria di annotazioni alle origini Kotlin, con il risultato del supporto di siti di utilizzo target specifici di Kotlin e di altre funzionalità di annotazione compatibili con Kotlin.

Versione 1.4.0

Versione 1.4.0

15 giugno 2022

androidx.annotation:annotation:1.4.0 viene rilasciato. La versione 1.4.0 contiene questi commit.

Modifiche importanti dalla versione 1.3.0

  • È stata eseguita la migrazione di @RestrictTo alle origini Kotlin e ora supporta il sito di utilizzo @file. Di conseguenza, la libreria Annotation ora dipende dalla libreria standard di Kotlin.
  • @ReturnThis (b/140249763): garantisce che i metodi di override di questo metodo debbano restituire la stessa istanza (destinata ai costruttori e così via)
  • @OpenForTesting (b/141539024): i metodi e le classi Kotlin contrassegnati come "open" possono essere annotati con questa annotazione e lint si assicurerà che questa classe sia sottoclassificata solo (e i metodi solo sostituiti) dai test di unità
  • @DeprecatedSinceApi (b/37116481): indica che il metodo (o la classe o il campo) annotato fa parte di una libreria di backport per un'API di piattaforma che non è più necessaria a partire dal livello API specificato.
  • @EmptySuper: indica che questo metodo è definito come vuoto, quindi non è necessario chiamarlo quando lo sostituisci (e in effetti non dovresti; ad esempio, può contenere controlli di compatibilità con le versioni precedenti).

Versione 1.4.0-rc01

1° giugno 2022

androidx.annotation:annotation:1.4.0-rc01 viene rilasciato. La versione 1.4.0-rc01 contiene questi commit.

  • L'interfaccia e le funzionalità dell'API sono state finalizzate per il rilascio.

Versione 1.4.0-beta01

18 maggio 2022

androidx.annotation:annotation:1.4.0-beta01 viene rilasciato. La versione 1.4.0-beta01 contiene questi commit.

  • Nessuna modifica dall'ultima versione alpha. L'API è stata bloccata per la versione beta.

Versione 1.4.0-alpha02

9 febbraio 2022

androidx.annotation:annotation:1.4.0-alpha02 viene rilasciato. La versione 1.4.0-alpha02 contiene questi commit.

Nuove funzionalità

  • Sono state aggiunte le annotazioni @ReturnThis, @OpenForTesting, @EmptySuper e @DeprecatedSinceApi. (21946a2)

  • @ReturnThis (b/140249763): garantisce che i metodi di override di questo metodo debbano restituire la stessa istanza (destinata a costruttori e così via)

  • @OpenForTesting (b/141539024): i metodi e le classi Kotlin contrassegnati come "open" possono essere annotati con questa annotazione e lint si assicurerà che questa classe sia sottoclassificata solo (e i metodi siano sostituiti solo) dai test di unità

  • @DeprecatedSinceApi (b/37116481): indica che il metodo (o la classe o il campo) annotato fa parte di una libreria di backport per un'API di piattaforma che non è più necessaria a partire dal livello API specificato.

  • @EmptySuper: indica che questo metodo è definito come vuoto, quindi non è necessario chiamarlo quando lo sostituisci (e in effetti non dovresti; ad esempio, può contenere controlli di compatibilità con le versioni precedenti).

Versione 1.4.0-alpha01

15 dicembre 2021

androidx.annotation:annotation:1.4.0-alpha01 viene rilasciato. La versione 1.4.0-alpha01 contiene questi commit.

Modifiche all'API

  • È stata eseguita la migrazione dell'annotazione RestrictTo alle origini Kotlin (Ia6336)

Versione 1.3.0

Versione 1.3.0

3 novembre 2021

androidx.annotation:annotation:1.3.0 viene rilasciato. La versione 1.3.0 contiene questi commit.

Modifiche importanti dalla versione 1.2.0

  • Annotazione @Discouraged per contrassegnare le API che non possono essere ragionevolmente ritirate, ma hanno un impatto negativo significativo sul rendimento e non devono essere chiamate nel normale codice di produzione
  • Annotazione @Context per contrassegnare contesti generici in modo che gli sviluppatori possano eseguire la migrazione alle nuove API più facilmente
  • Annotazione @GravityInt per contrassegnare gli elementi contenenti valori di gravità impacchettati in interi
  • @InspectableProperty è stato ritirato in favore di @Attribute per androidx.resourceinspection

Versione 1.3.0-rc01

27 ottobre 2021

androidx.annotation:annotation:1.3.0-rc01 viene rilasciato. La versione 1.3.0-rc01 contiene questi commit.

Versione 1.3.0-beta01

29 settembre 2021

androidx.annotation:annotation:1.3.0-beta01 viene rilasciato. La versione 1.3.0-beta01 contiene questi commit.

Modifiche all'API

  • Richiedi una spiegazione in "message" per @Discouraged. (I3390f)
  • È stata aggiunta l'annotazione @Discouraged per contrassegnare gli elementi non consigliati. (Ib2549)
  • Rendere visibile l'annotazione RestrictTo dal popup dei documenti di Studio (Ie8e1a, b/183134648)

Correzioni di bug

  • Aggiungi l'annotazione del contesto per contrassegnare i contesti generici, in modo che gli sviluppatori possano eseguire la migrazione alle nuove API più facilmente. (Ie581a)

Versione 1.3.0-alpha01

24 marzo 2021

androidx.annotation:annotation:1.3.0-alpha01 viene rilasciato. La versione 1.3.0-alpha01 contiene questi commit.

Modifiche all'API

  • @InspectableProperty è stato deprecato in favore di @Attribute in androidx.resourceinspection. (Ic0eff)
  • È stata aggiunta l'annotazione @GravityInt per contrassegnare gli elementi contenenti valori di gravità impacchettati in interi. (Ifcaa4, b/180620048)

Annotazione - Versione sperimentale 1.5

Versione 1.5.0-beta01

9 aprile 2025

androidx.annotation:annotation-experimental:1.5.0-beta01 viene rilasciato. La versione 1.5.0-beta01 contiene questi commit.

Modifiche importanti

  • Questa libreria ora ha come target il livello di linguaggio Kotlin 2.0 e richiede KGP 2.0.0 o versioni successive (Idb6b5)

Versione 1.5.0-alpha01

21 agosto 2024

androidx.annotation:annotation-experimental:1.5.0-alpha01 viene rilasciato. La versione 1.5.0-alpha01 contiene questi commit.

Modifiche all'API

  • Aggiungi message a RequiresOptIn per far corrispondere l'annotazione stdlib di Kotlin al valore predefinito di stringa vuota. (I1f50e)

Annotazione - Versione sperimentale 1.4

Versione 1.4.1

3 aprile 2024

androidx.annotation:annotation-experimental:1.4.1 viene rilasciato. La versione 1.4.1 contiene questi commit.

Correzioni di bug

  • Correggi l'utilizzo di isKotlin per evitare di attivare accidentalmente il controllo RequiresOptIn nei file Kotlin. (I2d8c1f)

Versione 1.4.0

24 gennaio 2024

androidx.annotation:annotation-experimental:1.4.0 viene rilasciato. La versione 1.4.0 contiene questi commit.

Modifiche importanti dalla versione 1.3.0

  • Aggiunta del supporto per Kotlin multipiattaforma
  • Correggere la compatibilità con Kotlin 2.0
  • Mostrare avvisi per gli utilizzi Java di proprietà Kotlin annotate sperimentalmente (I8bd43)
  • Correggere il posizionamento dell'annotazione di correzione automatica nei metodi Kotlin (Id7a41)

Versione 1.4.0-rc01

10 gennaio 2024

androidx.annotation:annotation-experimental:1.4.0-rc01 viene rilasciato. La versione 1.4.0-rc01 non contiene modifiche rispetto alla release precedente.

Versione 1.4.0-beta01

13 dicembre 2023

androidx.annotation:annotation-experimental:1.4.0-beta01 viene rilasciato. Non sono state apportate modifiche rispetto alla release precedente.

Versione 1.4.0-alpha01

29 novembre 2023

androidx.annotation:annotation-experimental:1.4.0-alpha01 viene rilasciato. La versione 1.4.0-alpha01 contiene questi commit.

Correzioni di bug

  • Rimuovi temporaneamente i suggerimenti di correzione automatica a livello di classe per aggirare il problema b/301598518. (Id98b2)
  • Mostrare avvisi per gli utilizzi Java di proprietà Kotlin annotate sperimentalmente (I8bd43)
  • Correggere il posizionamento dell'annotazione di correzione automatica nei metodi Kotlin (Id7a41)

Versione 1.4.0-dev01

8 febbraio 2023

androidx.annotation:annotation-experimental:1.4.0-dev01 viene rilasciato. La versione 1.4.0-dev01 contiene questi commit.

  • Annotation-experimental ha abilitato Kotlin multipiattaforma per la versione di anteprima per sviluppatori 1.4.0-dev01.

Annotazione - Versione sperimentale 1.3.1

Versione 1.3.1

21 giu 2023

androidx.annotation:annotation-experimental:1.3.1 viene rilasciato. La versione 1.3.1 contiene questi commit.

Correzioni di bug

  • Posiziona l'annotazione all'inizio dell'elenco dei modificatori quando applichi la correzione automatica di lint. (b/251172715)
  • Utilizzare il controllo lint per scoraggiare l'utilizzo di androidx.annotation.RequiresOptIn nelle sorgenti Kotlin (b/241097743)

Annotazione - Versione sperimentale 1.3.0

Versione 1.3.0

7 settembre 2022

androidx.annotation:annotation-experimental:1.3.0 viene rilasciato. La versione 1.3.0 contiene questi commit.

Modifiche importanti dalla versione 1.2.0

  • Aggiunta del supporto per l'utilizzo di @androidx.annotation.OptIn a livello di pacchetto (I24d58)
  • La dipendenza da stdlib di Kotlin è stata spostata nel tipo API anziché solo nella compilazione. Ciò significa che tutti i client della libreria Annotation-Experimental includeranno la libreria standard di Kotlin nelle dipendenze transitorie.

Versione 1.3.0-rc01

24 agosto 2022

androidx.annotation:annotation-experimental:1.3.0-rc01 viene rilasciato. La versione 1.3.0-rc01 contiene questi commit.

  • Nessuna modifica rispetto alla release precedente. L'implementazione è stata bloccata per la versione RC.

Versione 1.3.0-beta01

10 agosto 2022

androidx.annotation:annotation-experimental:1.3.0-beta01 viene rilasciato. La versione 1.3.0-beta01 contiene questi commit.

  • Nessuna modifica rispetto alla versione alpha. Questa libreria è stata stabilizzata per la versione beta.

Versione 1.3.0-alpha01

27 luglio 2022

androidx.annotation:annotation-experimental:1.3.0-alpha01 viene rilasciato. La versione 1.3.0-alpha01 contiene questi commit.

Modifiche all'API

  • Aggiunta del supporto per l'utilizzo di @androidx.annotation.OptIn a livello di pacchetto (I24d58)

Annotation-Experimental Version 1.2.0

Versione 1.2.0

15 dicembre 2021

androidx.annotation:annotation-experimental:1.2.0 viene rilasciato. La versione 1.2.0 contiene questi commit.

Modifiche importanti dalla versione 1.1.0

Questa libreria ora ha come target il livello di linguaggio Java 8.

Versione 1.2.0-rc01

1° dicembre 2021

androidx.annotation:annotation-experimental:1.2.0-rc01 viene rilasciato. La versione 1.2.0-rc01 contiene questi commit.

Nessuna modifica rispetto alla versione beta.

Versione 1.2.0-beta01

17 novembre 2021

androidx.annotation:annotation-experimental:1.2.0-beta01 viene rilasciato. La versione 1.2.0-beta01 contiene questi commit.

Modifiche all'API

Le API sono state finalizzate per la versione beta.

Annotation-Experimental Version 1.2.0-alpha01

30 giugno 2021

androidx.annotation:annotation-experimental:1.2.0-alpha01 viene rilasciato. La versione 1.2.0-alpha01 contiene questi commit.

Nuove funzionalità

  • La libreria ora ha come target il livello di linguaggio Java 8

Versione 1.2.0

Versione 1.2.0

24 marzo 2021

androidx.annotation:annotation:1.2.0 viene rilasciato. La versione 1.2.0 contiene questi commit.

Modifiche principali dalla versione 1.1.0

  • È stata aggiunta l'annotazione @ChecksSdkIntAtLeast, che può essere utilizzata per identificare i metodi o i campi utilizzati per limitare l'accesso a livello di SDK e soddisfare il controllo di lint NewApi.
  • È stata aggiunta l'annotazione @DoNotInline, abbinata a una regola Proguard per impedire l'inserimento in linea dei membri durante l'ottimizzazione.
  • Ora una serie di annotazioni sono contrassegnate con @Documented per garantire che vengano visualizzate nella documentazione per gli elementi annotati.

Versione 1.2.0-rc01

24 febbraio 2021

androidx.annotation:annotation:1.2.0-rc01 viene rilasciato. La versione 1.2.0-rc01 contiene questi commit.

Versione 1.2.0-beta01

13 gennaio 2021

androidx.annotation:annotation:1.2.0-beta01 viene rilasciato. La versione 1.2.0-beta01 contiene questi commit.

Modifiche all'API

  • Nuova annotazione @DoNotInline che indica agli ottimizzatori di codice (ad es. Proguard, R8) di non inserire in linea il metodo annotato. (I3dfe8, b/141326133)

Versione 1.2.0-alpha01

14 maggio 2020

androidx.annotation:annotation:1.2.0-alpha01 viene rilasciato. La versione 1.2.0-alpha01 contiene questi commit.

Nuove funzionalità

  • È stata aggiunta l'annotazione @ChecksSdkIntAtLeast. In questo modo, androidx e gli utenti possono annotare metodi e campi che rappresentano un controllo SDK_INT. (I89a54, b/120255046)

Annotation-Experimental Version 1.1.0

Versione 1.1.0

7 aprile 2021

androidx.annotation:annotation-experimental:1.1.0 viene rilasciato. La versione 1.1.0 contiene questi commit.

Modifiche principali dalla versione 1.0.0

  • Le annotazioni sperimentali di Jetpack sono state riscritte in Kotlin per fornire il supporto di più classi di indicatori e una gestione migliorata del ritiro.
  • Le annotazioni RequiresOptIn e OptIn sono state aggiunte per garantire la parità con Kotlin, mentre le annotazioni Experimental e UsesExperimental sono state ritirate.

Versione 1.1.0-rc02

24 marzo 2021

androidx.annotation:annotation-experimental:1.1.0-rc02 viene rilasciato. La versione 1.1.0-rc02 contiene questi commit.

Correzioni di bug

  • Sono state aggiunte regole Proguard per garantire che l'ottimizzazione del codice non avvisi delle meta-annotazioni Kotlin mancanti.

Versione 1.1.0-rc01

10 marzo 2021

androidx.annotation:annotation-experimental:1.1.0-rc01 viene rilasciato. La versione 1.1.0-rc01 contiene questi commit.

Nessuna modifica rispetto alla release beta precedente.

Versione 1.1.0-beta01

27 gennaio 2021

androidx.annotation:annotation-experimental:1.1.0-beta01 viene rilasciato. La versione 1.1.0-beta01 contiene questi commit.

Modifiche all'API

  • La variante androidx dell'annotazione sperimentale è stata ritirata per garantire la parità con Kotlin. È stata sostituita da una variante androidx dell'annotazione RequiresOptIn e lo strumento di lint rivolto a Java è stato aggiornato per supportare sia la nuova annotazione Kotlin sia la nuova variante androidx. (I52495, b/151331381)

Versione 1.1.0-alpha01

22 luglio 2020

androidx.annotation:annotation-experimental:1.1.0-alpha01 viene rilasciato. La versione 1.1.0-alpha01 contiene questi commit.

Nuove funzionalità

  • La libreria di annotazioni sperimentale è ora scritta in Kotlin, ma non richiede l'inclusione della libreria standard di Kotlin come dipendenza. Include un file Proguard che consente di rimuovere i metadati Kotlin non necessari dai progetti che utilizzano solo il linguaggio di programmazione Java.
  • @UseExperimental ora supporta più classi di indicatori (aosp/1185577, b/145137892)

Annotation-Experimental Version 1.0.0

Annotation-Experimental Version 1.0.0

7 novembre 2019

androidx.annotation:annotation-experimental:1.0.0 e androidx.annotation:annotation-experimental-lint:1.0.0 vengono rilasciati senza modifiche dal giorno 1.0.0-rc01. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0

  • Applicazione delle semantiche di Kotlin @Experimental nel codice sorgente Java basata su Lint
  • Annotazioni Java che forniscono un comportamento equivalente alle annotazioni @Experimental e @UseExperimental di Kotlin senza la necessità di una dipendenza da Kotlin

Annotazione - Versione sperimentale 1.0.0-rc01

23 ottobre 2019

androidx.annotation:annotation-experimental:1.0.0-rc01 e androidx.annotation:annotation-experimental-lint:1.0.0-rc01 vengono rilasciati. La versione 1.0.0-rc01 contiene questi commit.

Problemi noti

Quando utilizzi la versione stabile di Studio 3.5, gli avvisi del rilevatore di lint per l'utilizzo di @Experimental non vengono visualizzati nell'IDE per gli utilizzi non validi di Java dell'annotazione Kotlin @Experimental. Consulta b/140640322.

Annotation-Experimental Version 1.0.0-beta01

9 ottobre 2019

androidx.annotation:annotation-experimental:1.0.0-beta01 e androidx.annotation:annotation-experimental-lint:1.0.0-beta01 vengono rilasciati senza modifiche dalla versione 1.0.0-alpha01. La versione 1.0.0-beta01 contiene questi commit.

Annotazione - Versione sperimentale 1.0.0-alpha01

18 settembre 2019

androidx.annotation:annotation-experimental:1.0.0-alpha01 e androidx.annotation:annotation-experimental-lint:1.0.0-alpha01 vengono rilasciati. Questi sono i commit inclusi in annotation-experimental 1.0.0-alpha01 e questi sono i commit inclusi in annotation-experimental-lint 1.0.0-alpha01

Nuove funzionalità

  • La libreria di annotazioni Jetpack Experimental fornisce un'implementazione compatibile con Java degli indicatori API sperimentali di Kotlin. L'elemento -lint fornisce un'implementazione basata su Lint delle restrizioni di utilizzo sperimentali e applica restrizioni agli utilizzi Java degli indicatori API sperimentali nativi di Kotlin.

  • Quando utilizzi l'elemento annotation-experimental come dipendenza, le regole Lint fornite dall'elemento annotation-experimental verranno applicate automaticamente.annotation-experimental-lint

Versione 1.1.0

Versione 1.1.0

5 giugno 2019

androidx.annotation:annotation:1.1.0 viene rilasciato senza modifiche rispetto alla versione 1.1.0-rc01.

Versione 1.1.0-rc01

7 maggio 2019

androidx.annotation:annotation:1.1.0-rc01 viene rilasciato senza modifiche rispetto a 1.1.0-beta01. I commit inclusi in questa versione sono disponibili qui.

Versione 1.1.0-beta01

3 aprile 2019

androidx.annotation:annotation:1.1.0-beta01 viene rilasciato. I commit inclusi in questa versione sono disponibili qui.

Nuove funzionalità

  • Nuova @InspectablePropertyannotazione per supportare le nuove API di ispezione delle visualizzazioni aggiunte in Android 10. Questa annotazione può essere applicata ai getter nelle visualizzazioni o in altri elementi dell'interfaccia utente. Gli strumenti di generazione di codice possono utilizzarlo per creare oggetti companion che mappano i nomi delle proprietà e gli ID attributo ai valori delle proprietà senza il sovraccarico della riflessione.

Modifiche all'API

  • Modifica che comporta una interruzione: @ContentView è stato modificato in un'annotazione del costruttore e il valore @LayoutRes è stato rimosso. Le classi che vogliono supportare le annotazioni @ContentView devono aggiungerle a un costruttore che accetta un parametro @LayoutRes int. In questo modo viene risolto un problema relativo all'utilizzo di questa annotazione nei moduli della libreria. (b/128352521)

Versione 1.1.0-alpha02

13 marzo 2019

androidx.annotation:annotation:1.1.0-alpha02 viene rilasciato. L'elenco completo dei commit inclusi in questa versione è disponibile qui.

Nuove funzionalità

  • Nuovo ambito di limitazione delle API: RestrictTo.Scope.LIBRARY_GROUP_PREFIX. Limita l'utilizzo al codice all'interno dei pacchetti i cui gruppi condividono lo stesso prefisso del gruppo di librerie fino all'ultimo . (periodo). Ad esempio, poiché le librerie foo.bar:lib1 e foo.baz:lib2 condividono il prefisso foo, possono utilizzare le API l'una dell'altra che sono limitate a questo ambito. Analogamente, com.foo.bar:lib1 e com.foo.baz:lib2 condividono il prefisso com.foo. e possono condividere API limitate a quello scopo. Tuttavia, la raccolta com.bar.qux:lib3 non potrà utilizzare l'API limitata perché condivide solo il prefisso com. e non fino all'ultimo . (punto).

Versione 1.1.0-alpha01

30 gennaio 2019

androidx.annotation:annotation 1.1.0-alpha01 viene rilasciato.

Nuove funzionalità

  • È stata aggiunta un'annotazione @ContentView che consente di indicare quale file XML del layout deve essere espanso. Questa funzionalità è supportata in ComponentActivity nella versione 1.0.0-alpha04 e in Fragment nella versione 1.1.0-alpha04 come alternativa all'utilizzo di setContentView() o all'override di onCreateView(), rispettivamente. (aosp/837619)

Versione 1.0.2

Versione 1.0.2

25 febbraio 2019

androidx.annotation:annotation 1.0.2 viene rilasciato.

Correzioni di bug

  • Correggi le regole R8/ProGuard incorporate nel file JAR. Facevano riferimento in modo errato ai vecchi tipi android.support.annotation anziché a androidx.annotation. Nota: questo avrebbe avuto un impatto sulle tue build solo se non utilizzavi getDefaultProguardFile, poiché queste regole predefinite includevano anche regole corrette per entrambi i pacchetti. (aosp/891685)
  • Aggiungi una regola R8/ProGuard che mantenga esplicitamente l'annotazione @Keep stessa. In questo modo, ProGuard non rimuove l'annotazione dai tipi prima di rispettarne effettivamente la semantica. Nota: questo avrebbe avuto un impatto sulle tue build solo se non utilizzavi getDefaultProguardFile, poiché queste regole predefinite includevano anche regole corrette per entrambi i pacchetti. (aosp/903818)