Annotazione

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

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

Elemento Release stabile Candidato per la release Release beta Release alpha
annotazione 1.9.1 - - -
annotation-experimental 1.5.1 - - 1.6.0-alpha01
Ultimo aggiornamento della libreria: 22 ottobre 2025

Dichiara le dipendenze

Per aggiungere una dipendenza da Annotation, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

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

Alla moda

dependencies {
    implementation "androidx.annotation:annotation:1.9.1"
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation "androidx.annotation:annotation-experimental:1.5.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.5.1")
}

Per saperne di più sulle dipendenze, consulta Aggiungi dipendenze di build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa libreria. Prima di segnalare un nuovo problema, 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.

Crea un nuovo problema

Per ulteriori informazioni, consulta la documentazione di Issue Tracker.

Versione 1.9

Versione 1.9.1

30 ottobre 2024

androidx.annotation:annotation-*:1.9.1 è stato 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 è stato rilasciato. La versione 1.9.0 contiene questi commit.

Modifiche importanti dalla versione 1.8.0

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

Versione 1.9.0-rc01

2 ottobre 2024

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

Versione 1.9.0-beta01

18 settembre 2024

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

Modifiche alle API

  • Aggiunge il supporto per la piattaforma di destinazione watchosDeviceArm64 (I1cc04, b/364652024)

Versione 1.9.0-alpha03

4 settembre 2024

androidx.annotation:annotation-*:1.9.0-alpha03 è stato 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 è stato 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 è stato rilasciato. La versione 1.9.0-alpha01 contiene questi commit.

Contributo esterno

  • Aggiunge il 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 è stato 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 è stato rilasciato. La versione 1.8.1 contiene questi commit.

Correzioni di bug

  • Include target multipiattaforma Kotlin aggiuntivi: watchos, tvos.

Versione 1.8.0

14 maggio 2024

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

Modifiche importanti dalla versione 1.7.0

  • Aggiunta dell'annotazione @ReplaceWith per esprimere le sostituzioni delle API ritirate
  • L'annotazione @MainThread è stata spostata nel set di origini comune.

Versione 1.8.0-rc01

1° maggio 2024

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

Versione 1.8.0-beta02

17 aprile 2024

androidx.annotation:annotation-*:1.8.0-beta02 è stato 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 è stato 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 correzione automatica non è ancora stato rilasciato

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 è stato rilasciato. La versione 1.8.0-alpha01 contiene questi commit.

Modifiche alle API

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

Contributi esterni

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

Versione 1.7

Versione 1.7.1

13 dicembre 2023

androidx.annotation:annotation-*:1.7.1 è stato 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 è stato rilasciato. La versione 1.7.0 contiene questi commit.

Modifiche importanti dalla versione 1.6.0

  • Include artefatti Kotlin Multiplatform che hanno come target le piattaforme iOS, Linux e macOS.
  • Ora puoi utilizzare le annotazioni nei progetti KMM. Tieni presente che i target non Android delle annotazioni sono ancora sperimentali, ma abbiamo deciso di unire le versioni per consentire agli sviluppatori di provarli più facilmente. Nello specifico, alcune annotazioni potrebbero spostarsi tra il codice comune e quello specifico della piattaforma durante lo sviluppo alpha, mentre definiamo i limiti.

Versione 1.7.0-rc01

23 agosto 2023

androidx.annotation:annotation-*:1.7.0-rc01 è stato 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 è stato 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 è stato rilasciato. La versione 1.7.0-alpha03 contiene questi commit.

Correzioni di bug

  • La pubblicazione POM Maven ora include l'artefatto multipiattaforma predefinito destinato alla JVM come dipendenza

Versione 1.7.0-alpha02

24 marzo 2023

androidx.annotation:annotation-*:1.7.0-alpha02 è stato rilasciato.

Correzioni di bug

  • Sono stati rimossi i vincoli di dipendenza dagli artefatti Maven per risolvere un problema di build in Kotlin Native Targets (b/274786186, KT-57531).

Versione 1.7.0-alpha01

22 marzo 2023

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

Nuove funzionalità

  • Include artefatti Kotlin Multiplatform che hanno come target le piattaforme iOS, Linux e macOS.
  • Ora puoi utilizzare le annotazioni nei progetti KMM. Tieni presente che i target non Android delle annotazioni sono ancora sperimentali, ma abbiamo deciso di unire le versioni per consentire agli sviluppatori di provarli più facilmente. Nello specifico, alcune annotazioni potrebbero spostarsi tra il codice comune e quello specifico della piattaforma durante lo sviluppo alpha, mentre definiamo i limiti.

Versione 1.6

Versione 1.6.0

22 febbraio 2023

androidx.annotation:annotation:1.6.0 e androidx.annotation:annotation-jvm:1.6.0 sono stati 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 versione specifica di un SDK di estensione specifico (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 sono stati rilasciati. La versione 1.6.0-rc01 contiene questi commit.

  • L'annotazione è stata stabilizzata per la release candidata 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 è stato 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 è stato rilasciato. La versione 1.6.0-dev01 contiene questi commit.

  • L'annotazione ha abilitato Kotlin multipiattaforma per l'anteprima per sviluppatori 1.6.0-dev01.

Nuove funzionalità

  • Aggiunge un'annotazione @RequiresExtension per indicare che un'API richiede una versione specifica 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 è stato rilasciato. La versione 1.5.0 contiene questi commit.

Modifiche importanti dalla versione 1.4.0

  • La libreria di annotazioni è stata completamente migrata alle origini Kotlin, il che comporta il supporto di siti di utilizzo di destinazione 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 è stato rilasciato. La versione 1.5.0-rc01 contiene questi commit.

  • Nessuna modifica rispetto alla precedente release beta 1.5.0.

Versione 1.5.0-beta01

24 agosto 2022

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

  • Nessuna modifica rispetto alla release precedente. La superficie dell'API è stata bloccata per la versione beta.

Versione 1.5.0-alpha02

10 agosto 2022

androidx.annotation:annotation:1.5.0-alpha02 è stato 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 è stato rilasciato. La versione 1.5.0-alpha01 contiene questi commit.

Nuove funzionalità

  • La libreria di annotazioni è stata completamente migrata alle origini Kotlin, il che comporta il supporto di siti di utilizzo di destinazione 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 è stato rilasciato. La versione 1.4.0 contiene questi commit.

Modifiche importanti dalla versione 1.3.0

  • @RestrictTo è stato migrato alle origini Kotlin e ora supporta il sito di utilizzo di @file. Di conseguenza, la libreria Annotation ora dipende dalla libreria standard Kotlin.
  • @ReturnThis (b/140249763): garantisce che i metodi di override di questo metodo restituiscano la stessa istanza (destinata a builder e così via)
  • @OpenForTesting (b/141539024): le classi e i metodi Kotlin contrassegnati come "open" possono essere annotati con questa annotazione e lint si assicurerà che questa classe venga sottoclassata (e i metodi sottoposti a override) solo dai test unitari
  • @DeprecatedSinceApi (b/37116481): indica che il metodo (o la classe o il campo) annotato fa parte di una libreria di backport per un'API della piattaforma, che non è più necessaria a partire dal livello API specificato.
  • @EmptySuper: indica che questo metodo è definito come vuoto, quindi quando lo esegui l'override non è necessario chiamarlo (e in realtà non dovresti; ad esempio, può contenere il controllo della compatibilità con le versioni precedenti).

Versione 1.4.0-rc01

1° giugno 2022

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

  • La superficie 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 è stato rilasciato. La versione 1.4.0-beta01 contiene questi commit.

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

Versione 1.4.0-alpha02

9 febbraio 2022

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

Nuove funzionalità

  • Aggiunte le annotazioni @ReturnThis, @OpenForTesting, @EmptySuper e @DeprecatedSinceApi. (21946a2)

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

  • @OpenForTesting (b/141539024): le classi e i metodi Kotlin contrassegnati come "open" possono essere annotati con questa annotazione e Lint si assicurerà che questa classe venga sottoclassificata (e i metodi sottoposti a override) solo dai test unitari

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

  • @EmptySuper: indica che questo metodo è definito come vuoto, quindi quando lo esegui l'override non è necessario chiamarlo (e in realtà non dovresti; ad esempio, può contenere il controllo della compatibilità con le versioni precedenti).

Versione 1.4.0-alpha01

15 dicembre 2021

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

Modifiche alle 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 è stato 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 ritirate in modo ragionevole, ma che hanno un impatto negativo significativo sulle prestazioni e non devono essere chiamate nel codice di produzione normale
  • Annotazione @Context per contrassegnare i contesti generici in modo che gli sviluppatori possano eseguire più facilmente la migrazione alle nuove API
  • Annotazione @GravityInt per contrassegnare gli elementi contenenti valori di gravità compressi in numeri interi
  • @InspectableProperty deprecato a favore di @Attribute per androidx.resourceinspection

Versione 1.3.0-rc01

27 ottobre 2021

androidx.annotation:annotation:1.3.0-rc01 è stato 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 è stato rilasciato. La versione 1.3.0-beta01 contiene questi commit.

Modifiche alle API

  • Richiedi una spiegazione nel "messaggio" per @Discouraged. (I3390f)
  • Aggiunta dell'annotazione @Discouraged per contrassegnare gli elementi sconsigliati. (Ib2549)
  • Rendi visibile l'annotazione RestrictTo dal popup dei documenti di Studio (Ie8e1a, b/183134648)

Correzioni di bug

  • Aggiungi l'annotazione Context 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 è stato rilasciato. La versione 1.3.0-alpha01 contiene questi commit.

Modifiche alle API

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

Annotazione - Versione sperimentale 1.6

Versione 1.6.0-alpha01

22 ottobre 2025

androidx.annotation:annotation-experimental:1.6.0-alpha01 è stato rilasciato. La versione 1.6.0-alpha01 contiene questi commit.

Modifiche alle API

  • L'annotazione OptIn ora supporta la destinazione ElementType.PARAMETER.

Annotazione - Versione sperimentale 1.5

Versione 1.5.1

16 luglio 2025

androidx.annotation:annotation-experimental:1.5.1 è stato rilasciato. La versione 1.5.1 contiene questi commit.

Versione 1.5.0

7 maggio 2025

androidx.annotation:annotation-experimental:1.5.0 è stato rilasciato. La versione 1.5.0 contiene questi commit.

Modifiche importanti dalla versione 1.4.0

  • È stato aggiunto message a RequiresOptIn per corrispondere all'annotazione stdlib di Kotlin con il valore predefinito di stringa vuota. (I1f50e)
  • Questa libreria ora ha come target il livello del linguaggio Kotlin 2.0 e richiede KGP 2.0.0 o versioni successive. (Idb6b5)

Versione 1.5.0-rc01

23 aprile 2025

androidx.annotation:annotation-experimental:1.5.0-rc01 è stato rilasciato. La versione 1.5.0-rc01 non contiene modifiche rispetto alla versione beta precedente. Consulta i commit.

Versione 1.5.0-beta01

9 aprile 2025

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

Modifiche importanti

  • Questa libreria ora ha come target il livello del 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 è stato rilasciato. La versione 1.5.0-alpha01 contiene questi commit.

Modifiche alle API

  • Aggiungi message a RequiresOptIn per corrispondere all'annotazione stdlib di Kotlin con il valore stringa vuota predefinito. (I1f50e)

Annotazione - Versione sperimentale 1.4

Versione 1.4.1

3 aprile 2024

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

Correzioni di bug

  • Correzione dell'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 è stato rilasciato. La versione 1.4.0 contiene questi commit.

Modifiche importanti dalla versione 1.3.0

  • Aggiungi il supporto per Kotlin multi-piattaforma
  • Correzione della compatibilità con Kotlin 2.0
  • Mostra avvisi per gli utilizzi Java delle proprietà Kotlin annotate in modo sperimentale (I8bd43)
  • Correzione del posizionamento dell'annotazione di correzione automatica sui metodi Kotlin (Id7a41)

Versione 1.4.0-rc01

10 gennaio 2024

androidx.annotation:annotation-experimental:1.4.0-rc01 è stato 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 è stato 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 è stato 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 risolvere il problema b/301598518. (Id98b2)
  • Mostra avvisi per gli utilizzi Java delle proprietà Kotlin annotate in modo sperimentale (I8bd43)
  • Correzione del posizionamento dell'annotazione di correzione automatica sui metodi Kotlin (Id7a41)

Versione 1.4.0-dev01

8 febbraio 2023

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

  • Annotation-experimental ha abilitato Kotlin multipiattaforma per l'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 è stato 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)
  • Utilizza il controllo lint per scoraggiare l'utilizzo di androidx.annotation.RequiresOptIn nelle origini Kotlin (b/241097743)

Annotazione - Versione sperimentale 1.3.0

Versione 1.3.0

7 settembre 2022

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

Modifiche importanti dalla versione 1.2.0

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

Versione 1.3.0-rc01

24 agosto 2022

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

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

Versione 1.3.0-beta01

10 agosto 2022

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

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

Versione 1.3.0-alpha01

27 luglio 2022

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

Modifiche alle API

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

Annotazione - Versione sperimentale 1.2.0

Versione 1.2.0

15 dicembre 2021

androidx.annotation:annotation-experimental:1.2.0 è stato 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 è stato 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 è stato rilasciato. La versione 1.2.0-beta01 contiene questi commit.

Modifiche alle API

Le API sono state finalizzate per la versione beta.

Annotazione - Versione sperimentale 1.2.0-alpha01

30 giugno 2021

androidx.annotation:annotation-experimental:1.2.0-alpha01 è stato 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 è stato 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 controllare l'accesso a livello di SDK e soddisfare il controllo lint NewApi.
  • È stata aggiunta l'annotazione @DoNotInline, che viene abbinata a una regola Proguard per impedire l'inline dei membri durante l'ottimizzazione.
  • Ora diverse annotazioni sono annotate con @Documented per garantire che vengano visualizzate nella documentazione per i membri annotati.

Versione 1.2.0-rc01

24 febbraio 2021

androidx.annotation:annotation:1.2.0-rc01 è stato 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 è stato rilasciato. La versione 1.2.0-beta01 contiene questi commit.

Modifiche alle API

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

Versione 1.2.0-alpha01

14 maggio 2020

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

Nuove funzionalità

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

Annotazione - Versione sperimentale 1.1.0

Versione 1.1.0

7 aprile 2021

androidx.annotation:annotation-experimental:1.1.0 è stato 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 supporto per più classi di marcatori e una migliore gestione della deprecazione.
  • Sono state aggiunte le annotazioni RequiresOptIn e OptIn per garantire la parità con Kotlin e le annotazioni Experimental e UsesExperimental sono state ritirate.

Versione 1.1.0-rc02

24 marzo 2021

androidx.annotation:annotation-experimental:1.1.0-rc02 è stato 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 della mancanza di meta-annotazioni Kotlin.

Versione 1.1.0-rc01

10 marzo 2021

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

Nessuna modifica rispetto alla versione beta precedente.

Versione 1.1.0-beta01

27 gennaio 2021

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

Modifiche alle API

  • La variante androidx dell'annotazione Experimental è stata ritirata per garantire la parità con Kotlin. È stata sostituita da una variante androidx dell'annotazione RequiresOptIn e il linter 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 è stato rilasciato. La versione 1.1.0-alpha01 contiene questi commit.

Nuove funzionalità

  • La libreria di annotazioni sperimentali è ora scritta in Kotlin, ma non richiede l'inclusione della libreria standard 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 marcatori (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 viene rilasciato senza modifiche dal giorno 1.0.0-rc01. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0

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

Annotation-Experimental versione 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 sono stati 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 lint di utilizzo di @Experimental non vengono visualizzati nell'IDE per gli utilizzi Java non validi dell'annotazione Kotlin @Experimental. Vedi 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 rispetto alla 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 sono stati 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 sperimentali di Jetpack fornisce un'implementazione compatibile con Java dei marcatori API sperimentali di Kotlin. L'artefatto -lint fornisce un'implementazione basata su Lint delle restrizioni di utilizzo sperimentali e applica restrizioni agli utilizzi Java dei marcatori API sperimentali nativi di Kotlin.

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

Versione 1.1.0

Versione 1.1.0

5 giugno 2019

androidx.annotation:annotation:1.1.0 viene rilasciata 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 è stato rilasciato. I commit inclusi in questa versione sono disponibili qui.

Nuove funzionalità

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

Modifiche all'API

  • Modifica che causa interruzione: @ContentView è stata modificata in un'annotazione del costruttore e il valore @LayoutRes è stato rimosso. Le classi che vogliono supportare le annotazioni @ContentView devono aggiungere questa annotazione a un costruttore che accetta un parametro @LayoutRes int. È stato risolto un problema relativo all'utilizzo di questa annotazione nei moduli della raccolta. (b/128352521)

Versione 1.1.0-alpha02

13 marzo 2019

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

Nuove funzionalità

  • Nuovo ambito di limitazione dell'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 . (punto). 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. Allo stesso modo, per com.foo.bar:lib1 e com.foo.baz:lib2 condividono il prefisso com.foo. e possono condividere le API limitate a questo ambito. La libreria com.bar.qux:lib3, tuttavia, non potrà utilizzare l'API con limitazioni 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 è stato rilasciato.

Nuove funzionalità

  • È stata aggiunta un'annotazione @ContentView che consente di indicare quale file XML di layout deve essere visualizzato. Questa funzionalità è supportata in ComponentActivity nelle versioni 1.0.0-alpha04 e 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 è stato rilasciato.

Correzioni di bug

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