Annotazione

  
Esponi metadati che aiutino strumenti e 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 Versione beta Release alpha
annotazione 1.7.1 - 1.8.0-beta01 -
annotazione-sperimentale 1.4.1 - - -
Ultimo aggiornamento di questa raccolta: 3 aprile 2024

Dichiarazione delle dipendenze

Per aggiungere una dipendenza all'annotazione, devi aggiungere il Repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il Repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per l'app o il modulo:

trendy

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

Per ulteriori informazioni sulle dipendenze, vedi Aggiungere dipendenze build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se rilevi nuovi problemi o hai idee per migliorare la libreria. Dai un'occhiata ai problemi esistenti in questa libreria prima di crearne una nuova. 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.8

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 è stato ancora spedito

Versione 1.8.0-alpha02

20 marzo 2024

androidx.annotation:annotation-*:1.8.0-alpha02 viene rilasciato senza modifiche degne di nota. 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 alle API

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

Contributi esterni

  • Grazie 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 della 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

  • Include elementi Kotlin Multiplatform destinati a 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 provarle più facilmente. In particolare, alcune annotazioni potrebbero spostarsi tra il codice comune e quello specifico della piattaforma durante lo sviluppo alpha, una volta finalizzati 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 Maven POM ora include l'artefatto multipiattaforma target JVM predefinito come dipendenza

Versione 1.7.0-alpha02

24 marzo 2023

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

Correzioni di bug

  • Rimossi i vincoli di dipendenza dagli artefatti Maven per risolvere un problema di build nelle destinazioni native di Kotlin (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à

  • Include elementi Kotlin Multiplatform destinati a 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 provarle più facilmente. In particolare, alcune annotazioni potrebbero spostarsi tra il codice comune e quello specifico della piattaforma durante lo sviluppo alpha, una volta finalizzati 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 particolare SDK delle estensioni (I5e4fe)
  • Libreria di annotazioni convertita per creare mediante la toolchain multipiattaforma Kotlin (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 il candidato di release 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 da 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 abilitato Kotlin multi-piattaforma per l'anteprima per sviluppatori 1.6.0-dev01.

Nuove funzionalità

  • Aggiunge un'annotazione @RequiresExtension per indicare che un'API richiede una determinata versione di un SDK di estensione specifico. (I5e4fe).
  • Libreria di annotazioni convertita per creare mediante la toolchain multipiattaforma Kotlin (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

  • La libreria delle annotazioni è stata migrata completamente alle origini Kotlin, con il conseguente supporto per i siti di utilizzo di destinazione specifici per Kotlin e 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 precedente release beta 1.5.0.

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. La superficie 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 precedente release alpha.

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à

  • La libreria delle annotazioni è stata migrata completamente alle origini Kotlin, con il conseguente supporto per i siti di utilizzo di destinazione specifici per Kotlin e 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 a origini Kotlin e ora supporta il sito di utilizzo @file. Di conseguenza, la libreria delle annotazioni ora dipende dalla libreria standard Kotlin.
  • @ReturnThis (b/140249763): assicura che i metodi di override di questo metodo restituiscano la stessa istanza (destinata ai builder e così via)
  • @OpenForTesting (b/141539024): è possibile annotare con questa annotazione le classi e i metodi Kotlin contrassegnati come "aperti" e il lint garantirà che questa classe sia sottoclassificata (e che solo i metodi vengano sottoposti a override) dai test delle 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 della piattaforma, che non è più necessaria a partire dal livello API specificato.
  • @EmptySuper: indica che questo metodo è vuoto, pertanto quando esegui l'override non è necessario chiamarlo (e in effetti non dovresti farlo; 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 viene rilasciato. La versione 1.4.0-rc01 contiene questi commit.

  • La piattaforma e le funzionalità API sono state finalizzate per la release.

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. La piattaforma API è stata bloccata per la release 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): assicura che i metodi di override di questo metodo restituiscano la stessa istanza (previsto per i builder e così via)

  • @OpenForTesting (b/141539024): è possibile annotare con questa annotazione le classi e i metodi Kotlin contrassegnati come "aperti" e il lint garantirà che questa classe sia solo sottoclasse (e che solo i metodi vengano sostituiti) dai test delle 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 della piattaforma, che non è più necessaria a partire dal livello API specificato.

  • @EmptySuper: indica che questo metodo è vuoto, pertanto quando esegui l'override non è necessario chiamarlo (e in effetti non dovresti farlo; 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 viene rilasciato. La versione 1.4.0-alpha01 contiene questi commit.

Modifiche alle API

  • 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 deprecate, ma hanno un impatto negativo significativo sulle prestazioni 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 a nuove API più facilmente
  • Annotazione @GravityInt per contrassegnare elementi contenenti valori di gravità impacchettati in numeri interi
  • Obsoleto di @InspectableProperty a 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 alle API

  • Richiedi una spiegazione in "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 di contesto per contrassegnare contesti generici, in modo che gli sviluppatori possano migrare più facilmente a nuove API. (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 alle API

  • Deprecato @InspectableProperty 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.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

  • Aggiungi il supporto per il modello multipiattaforma Kotlin
  • Correggi la compatibilità con Kotlin 2.0
  • Mostra avvisi per gli utilizzi di Java delle proprietà Kotlin con annotazioni sperimentali (I8bd43)
  • Correggere il 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 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 risolvere il problema b/301598518. (Id98b2)
  • Mostra avvisi per gli utilizzi di Java delle proprietà Kotlin con annotazioni sperimentali (I8bd43)
  • Correggere il 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 viene rilasciato. La versione 1.4.0-dev01 contiene questi commit.

  • L'annotazione-sperimentale ha abilitato Kotlin multipiattaforma per l'anteprima per gli 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 dei lint. (b/251172715)
  • Utilizza il controllo lint per scoraggiare l'utilizzo di androidx.annotation.RequiresOptIn nelle fonti 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

  • Aggiungi il supporto per l'utilizzo di @androidx.annotation.OptIn a livello di pacchetto (I24d58)
  • La dipendenza stdlib di Kotlin è stata spostata in tipo API, anziché in sola compilazione. Questo significa che tutti i client della libreria sperimentale di annotazione 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 viene 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 viene 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 viene rilasciato. La versione 1.3.0-alpha01 contiene questi commit.

Modifiche alle API

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

Annotazione-versione sperimentale 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 lingua 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 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 viene rilasciato. La versione 1.2.0-alpha01 contiene questi commit.

Nuove funzionalità

  • La libreria ora ha come target il livello di lingua 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.

Importanti modifiche dalla versione 1.1.0

  • È stata aggiunta l'annotazione @ChecksSdkIntAtLeast, che può essere utilizzata per identificare i metodi o i campi usati per limitare l'accesso a livello di SDK e soddisfare il controllo lint NewApi.
  • È stata aggiunta l'annotazione @DoNotInline, che è abbinata a una regola di Proguard per impedire che i membri vengano incorporati durante l'ottimizzazione.
  • Ora una serie di annotazioni sono contrassegnate con @Documented per garantire che vengano visualizzate nella documentazione dei membri 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 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 viene rilasciato. La versione 1.2.0-alpha01 contiene questi commit.

Nuove funzionalità

  • 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).

Annotazione-versione sperimentale 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.

Importanti modifiche dalla versione 1.0.0

  • Le annotazioni sperimentali di Jetpack sono state riscritte in Kotlin per fornire supporto per più classi di indicatori e una migliore gestione del ritiro.
  • Le annotazioni RequiresOptIn e OptIn sono state aggiunte per essere di 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 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 di 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 dalla 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 alle API

  • La variante androidx dell'annotazione sperimentale è stata ritirata per fornire lo stesso valore a Kotlin. È stata sostituita da una variante androidx dell'annotazione RichiedisOptIn e il linter 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 che la libreria standard Kotlin sia inclusa come dipendenza. Include un file Proguard che consente di eliminare 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)

Annotazione-versione sperimentale 1.0.0

Annotazione-versione sperimentale 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 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 bisogno 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 di utilizzo di @Experimental non vengono visualizzati nell'IDE per gli utilizzi Java non validi dell'annotazione @Experimental di Kotlin. Consulta la pagina b/140640322.

Annotazione-versione sperimentale 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 annotazioni-experimental 1.0.0-alpha01 e questi sono i commit inclusi in annotazioni-experimental-lint 1.0.0-alpha01

Nuove funzionalità

  • La libreria di annotazioni sperimentali Jetpack fornisce un'implementazione compatibile con Java degli indicatori sperimentali dell'API sperimentale di Kotlin. L'artefatto -lint fornisce un'implementazione basata su Lint delle restrizioni di utilizzo sperimentali e applica restrizioni sull'uso di Java degli indicatori API nativi sperimentali di Kotlin.

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

Versione 1.1.0

Versione 1.1.0

5 giugno 2019

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

Versione 1.1.0-rc01

7 maggio 2019

androidx.annotation:annotation:1.1.0-rc01 viene rilasciato senza modifiche da 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 sulle viste o su altri elementi dell'interfaccia utente. Gli strumenti per la generazione di codice possono utilizzarlo per creare oggetti associati che mappano i nomi e gli ID delle proprietà ai valori delle proprietà senza dover riflettere.

Modifiche alle API

  • Modifica che provoca un errore: @ContentView è stato modificato in un'annotazione del costruttore e il valore @LayoutRes è stato rimosso. I corsi che vogliono supportare le annotazioni @ContentView devono aggiungere questa annotazione a un costruttore che utilizza un parametro @LayoutRes int. Questo risolve un problema durante l'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 restrizione 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 usare le rispettive API limitate a questo ambito. Allo stesso modo, com.foo.bar:lib1 e com.foo.baz:lib2 condividono il prefisso com.foo. e possono condividere API limitate a quell'ambito. Tuttavia, la libreria com.bar.qux:lib3 non potrà utilizzare l'API soggetta a restrizioni 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 di layout deve essere aumentato in modo artificioso. Questa funzionalità è supportata in ComponentActivity nella release 1.0.0-alpha04 e Fragment nella release 1.1.0-alpha04, in alternativa all'utilizzo di setContentView() o all'override, rispettivamente, di onCreateView(). (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. Questi facevano riferimento erroneamente ai vecchi tipi di android.support.annotation anziché a androidx.annotation. Nota: questo avrebbe avuto un impatto sulle tue build solo se non utilizzassi getDefaultProguardFile, in quanto anche queste regole predefinite includevano le regole corrette per entrambi i pacchetti. (aosp/891685)
  • Aggiungi una regola R8/ProGuard che mantenga esplicitamente l'annotazione @Keep. In questo modo ProGuard non rimuove l'annotazione dai tipi prima di rispettarne la semantica. Nota: questo avrebbe avuto un impatto sulle tue build solo se non utilizzassi getDefaultProguardFile, in quanto anche queste regole predefinite includevano le regole corrette per entrambi i pacchetti. (aosp/903818).