Annotazione
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-beta02 | - |
annotazione-sperimentale | 1.4.1 | - | - | - |
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.
Per ulteriori informazioni, consulta la documentazione di Issue Tracker.
Versione 1.8
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 è 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
perandroidx.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
inandroidx.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 controlloRequiresOptIn
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 lintNewApi
. - È 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 controlloSDK_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
eOptIn
sono state aggiunte per essere di parità con Kotlin e le annotazioniExperimental
eUsesExperimental
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'artefattoannotation-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
@InspectableProperty
annotazione 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 libreriefoo.bar:lib1
efoo.baz:lib2
condividono il prefissofoo
, possono usare le rispettive API limitate a questo ambito. Allo stesso modo,com.foo.bar:lib1
ecom.foo.baz:lib2
condividono il prefissocom.foo.
e possono condividere API limitate a quell'ambito. Tuttavia, la libreriacom.bar.qux:lib3
non potrà utilizzare l'API soggetta a restrizioni perché condivide solo il prefissocom.
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 inComponentActivity
nella release1.0.0-alpha04
eFragment
nella release1.1.0-alpha04
, in alternativa all'utilizzo disetContentView()
o all'override, rispettivamente, dionCreateView()
. (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é aandroidx.annotation
. Nota: questo avrebbe avuto un impatto sulle tue build solo se non utilizzassigetDefaultProguardFile
, 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).