Adnotacja
Ta tabela zawiera listę wszystkich artefaktów w grupie androidx.annotation
.
Artefakt | Wersja stabilna | Kandydat do publikacji | Wersja Beta | Wersja alfa |
---|---|---|---|---|
adnotacja | 1.7.1 | - | 1.8.0-beta02 | - |
eksperymentalna z adnotacją | 1.4.1 | - | - | - |
Deklarowanie zależności
Aby dodać zależność od adnotacji, musisz dodać do projektu repozytorium Google Maven. Więcej informacji znajdziesz w repozytorium Google Maven.
W pliku build.gradle
aplikacji lub modułu dodaj zależności artefaktów, których potrzebujesz:
Odlotowy
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") }
Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.
Opinia
Twoja opinia pomoże nam ulepszyć Jetpack. Daj nam znać, jeśli znajdziesz nowe wydania lub masz pomysły na ulepszenie tej biblioteki. Zanim utworzysz nową bibliotekę, przejrzyj problemy z tą biblioteką. Możesz oddać głos w ramach istniejącego problemu, klikając przycisk gwiazdki.
Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.
Wersja 1.8
Wersja 1.8.0-beta02
17 kwietnia 2024 r.
Aplikacja androidx.annotation:annotation-*:1.8.0-beta02
została zwolniona. Wersja 1.8.0-beta02 nie zawiera żadnych zmian od poprzedniej wersji.
Wersja 1.8.0-beta01
3 kwietnia 2024 r.
Aplikacja androidx.annotation:annotation-*:1.8.0-beta01
została zwolniona. Wersja 1.8.0-beta01 zawiera te zatwierdzenia.
Nowe funkcje
- Adnotacja
ReplaceWith
jest teraz stabilna przy użyciu interfejsu API, ale powiązana z nią funkcja sprawdzania lintowania z funkcją autokorekty nie została jeszcze wysłana
Wersja 1.8.0-alfa02
20 marca 2024 r.
Wersja androidx.annotation:annotation-*:1.8.0-alpha02
została opublikowana bez istotnych zmian. Wersja 1.8.0-alpha02 zawiera te zatwierdzenia.
Wersja 1.8.0-alfa01
21 lutego 2024 r.
Aplikacja androidx.annotation:annotation-*:1.8.0-alpha01
została zwolniona. Wersja 1.8.0-alpha01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Dodano adnotację
@ReplaceWith
, która pozwala zastąpić wycofywane interfejsy API. (I38db3, b/322373864)
Treści opublikowane przez użytkowników z zewnątrz
- Dziękujemy Ivanowi Matkovowi za przeniesienie adnotacji
@MainThread
do wspólnego zbioru źródłowego. (6f228c)
Wersja 1.7
Wersja 1.7.1
13 grudnia 2023 r.
Aplikacja androidx.annotation:annotation-*:1.7.1
została zwolniona. Wersja 1.7.1 zawiera te zatwierdzenia.
Poprawki błędów
- Podczas wstawiania zależności domyślnej platformy użyj zakresu
compile
. (I4958f)
Wersja 1.7.0
6 września 2023 r.
Aplikacja androidx.annotation:annotation-*:1.7.0
została zwolniona. Wersja 1.7.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 1.6.0
- Obejmuje wieloplatformowe artefakty Kotlin kierowane na platformy iOS, Linux i macOS.
- Teraz możesz używać adnotacji w projektach KMM. Pamiętaj, że elementy docelowe adnotacji na urządzenia inne niż Android nadal są w fazie eksperymentalnej, ale zdecydowaliśmy się scalić wersje, aby ułatwić deweloperom ich testowanie. W szczególności w fazie rozwoju alfa niektóre adnotacje mogą się poruszać między kodem wspólnym a kodem przeznaczonym na konkretną platformę, gdy ograniczymy granice.
Wersja 1.7.0-rc01
23 sierpnia 2023 r.
Aplikacja androidx.annotation:annotation-*:1.7.0-rc01
została zwolniona. Wersja 1.7.0-rc01 zawiera te zatwierdzenia.
Ta wersja nie zawiera żadnych zmian z poprzedniej wersji beta.
Wersja 1.7.0-beta01
9 sierpnia 2023 r.
Aplikacja androidx.annotation:annotation-*:1.7.0-beta01
została zwolniona. Wersja 1.7.0-beta01 zawiera te zatwierdzenia.
Nowe funkcje
- Stabilizowane interfejsy API dla wersji
Wersja 1.7.0-alfa03
26 lipca 2023 r.
Aplikacja androidx.annotation:annotation-*:1.7.0-alpha03
została zwolniona. Wersja 1.7.0-alpha03 zawiera te zatwierdzenia.
Poprawki błędów
- Publikacja Maven POM zawiera teraz domyślny wieloplatformowy artefakt ukierunkowany na JVM jako zależność
Wersja 1.7.0-alfa02
24 marca 2023 r.
Aplikacja androidx.annotation:annotation-*:1.7.0-alpha02
została zwolniona.
Poprawki błędów
- Usunięto ograniczenia zależności z artefaktów Maven, aby obejść problem z kompilacją w natywnych celach Kotlin (b/274786186, KT-57531).
Wersja 1.7.0-alfa01
22 marca 2023 r.
Aplikacja androidx.annotation:annotation-*:1.7.0-alpha01
została zwolniona. Wersja 1.7.0-alpha01 zawiera te zatwierdzenia.
Nowe funkcje
- Obejmuje wieloplatformowe artefakty Kotlin kierowane na platformy iOS, Linux i macOS.
- Teraz możesz używać adnotacji w projektach KMM. Pamiętaj, że elementy docelowe adnotacji na urządzenia inne niż Android nadal są w fazie eksperymentalnej, ale zdecydowaliśmy się scalić wersje, aby ułatwić deweloperom ich testowanie. W szczególności w fazie rozwoju alfa niektóre adnotacje mogą się poruszać między kodem wspólnym a kodem przeznaczonym na konkretną platformę, gdy ograniczymy granice.
Wersja 1.6
Wersja 1.6.0
22 lutego 2023 roku
Opublikowano androidx.annotation:annotation:1.6.0
i androidx.annotation:annotation-jvm:1.6.0
. Wersja 1.6.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 1.5.0
- Dodaje adnotację
@RequiresExtension
, która informuje, że interfejs API wymaga konkretnej wersji konkretnego pakietu SDK rozszerzenia (I5e4fe). - Przekonwertowana biblioteka adnotacji do utworzenia za pomocą wieloplatformowego łańcucha narzędzi Kotlin (I3be8d)
Wersja 1.6.0-rc01
8 lutego 2023 r.
Opublikowano androidx.annotation:annotation:1.6.0-rc01
i androidx.annotation:annotation-jvm:1.6.0-rc01
. Wersja 1.6.0-rc01 zawiera te zatwierdzenia.
- Adnotacja do wersji 1.6.0-rc01 została ustabilizowana.
Wersja 1.6.0-beta01
25 stycznia 2023 r.
Wersje androidx.annotation:annotation:1.6.0-beta01
i androidx.annotation:annotation-jvm:1.6.0-beta01
zostały opublikowane bez zmian z 1.6.0-alpha01
.
Wersja 1.6.0-alfa01
11 stycznia 2023 r.
Aplikacja androidx.annotation:annotation-*:1.6.0-alpha01
została zwolniona. Wersja 1.6.0-alpha01 zawiera te zatwierdzenia.
Wersja 1.6.0-dev01
8 lutego 2023 r.
Aplikacja androidx.annotation:annotation-*:1.6.0-dev01
została zwolniona. Wersja 1.6.0-dev01 zawiera te zatwierdzenia.
- Adnotacja włączyła wieloplatformowe Kotlin w wersji przedpremierowej dla programistów w wersji 1.6.0-dev01.
Nowe funkcje
- Dodaje adnotację
@RequiresExtension
, która wskazuje, że interfejs API wymaga konkretnej wersji konkretnego pakietu SDK rozszerzenia. (I5e4fe) - Przekonwertowana biblioteka adnotacji do utworzenia za pomocą wieloplatformowego łańcucha narzędzi Kotlin (I3be8d)
Wersja 1.5.0
Wersja 1.5.0
21 września 2022 r.
Aplikacja androidx.annotation:annotation:1.5.0
została zwolniona. Wersja 1.5.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 1.4.0
- Biblioteka adnotacji została w pełni przeniesiona do źródeł Kotlin, co pozwoliło na obsługę witryn docelowych specyficznych dla Kotlin i inne funkcje adnotacji zgodne z Kotlin.
Wersja 1.5.0-rc01
7 września 2022 roku
Aplikacja androidx.annotation:annotation:1.5.0-rc01
została zwolniona. Wersja 1.5.0-rc01 zawiera te zatwierdzenia.
- Brak zmian w porównaniu z poprzednią wersją beta 1.5.0.
Wersja 1.5.0-beta01
24 sierpnia 2022 r.
Aplikacja androidx.annotation:annotation:1.5.0-beta01
została zwolniona. Wersja 1.5.0-beta01 zawiera te zatwierdzenia.
- Brak zmian w stosunku do poprzedniej wersji. Interfejs API został zablokowany w wersji beta.
Wersja 1.5.0-alfa02
10 sierpnia 2022 r.
Aplikacja androidx.annotation:annotation:1.5.0-alpha02
została zwolniona. Wersja 1.5.0-alpha02 zawiera te zatwierdzenia.
- Brak zmian od poprzedniej wersji alfa.
Wersja 1.5.0-alfa01
27 lipca 2022 roku
Aplikacja androidx.annotation:annotation:1.5.0-alpha01
została zwolniona. Wersja 1.5.0-alpha01 zawiera te zatwierdzenia.
Nowe funkcje
- Biblioteka adnotacji została w pełni przeniesiona do źródeł Kotlin, co pozwoliło na obsługę witryn docelowych specyficznych dla Kotlin i inne funkcje adnotacji zgodne z Kotlin.
Wersja 1.4.0
Wersja 1.4.0
15 czerwca 2022 r.
Aplikacja androidx.annotation:annotation:1.4.0
została zwolniona. Wersja 1.4.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 1.3.0
- Adres
@RestrictTo
został przeniesiony do źródeł Kotlin i obsługuje teraz witrynę wykorzystania@file
. W rezultacie biblioteka adnotacji bazuje teraz na standardowej bibliotece Kotlin. @ReturnThis
(b/140249763): zapewnia, że metody zastępowania tej metody muszą zwracać tę samą instancję (przeznaczone dla monterów itp.)@OpenForTesting
(b/141539024): do klas i metod Kotlin oznaczonych jako „otwarte” można dodać adnotacje z tą adnotacją. Litowanie zapewni, że klasa będzie odznaczać się tylko z klasy podrzędnej (i zastąpioną tylko nią) z testów jednostkowych.@DeprecatedSinceApi
(b/37116481): wskazuje, że metoda (lub klasa lub pole) z adnotacjami jest częścią biblioteki backendu dla interfejsu API platformy, która nie jest już potrzebna na danym poziomie interfejsu API.@EmptySuper
: wskazuje, że ta metoda jest zdefiniowana jako pusta, więc w przypadku zastępowania nie musisz jej wywoływać (a w rzeczywistości nie należy jej używać, na przykład może zawierać sprawdzanie zgodności wstecznej).
Wersja 1.4.0-rc01
1 czerwca 2022 r.
Aplikacja androidx.annotation:annotation:1.4.0-rc01
została zwolniona. Wersja 1.4.0-rc01 zawiera te zatwierdzenia.
- Zakończyliśmy wdrażanie interfejsu API i udostępniliśmy wszystkie jego funkcje.
Wersja 1.4.0-beta01
18 maja 2022 r.
Aplikacja androidx.annotation:annotation:1.4.0-beta01
została zwolniona. Wersja 1.4.0-beta01 zawiera te zatwierdzenia.
- Brak zmian od ostatniej wersji alfa. Interfejs API został zablokowany na potrzeby wersji beta.
Wersja 1.4.0-alfa02
9 lutego 2022 r.
Aplikacja androidx.annotation:annotation:1.4.0-alpha02
została zwolniona. Wersja 1.4.0-alpha02 zawiera te zatwierdzenia.
Nowe funkcje
Dodano adnotacje
@ReturnThis
,@OpenForTesting
,@EmptySuper
i@DeprecatedSinceApi
. (21946a2)@ReturnThis
(b/140249763): zapewnia, że metody zastępowania tej metody muszą zwracać tę samą instancję (przeznaczone dla monterów itp.)@OpenForTesting
(b/141539024): klasy i metody Kotlin oznaczone jako „otwarte” można dodać do adnotacji za pomocą tej adnotacji. Dzięki Litowaniu klasa będzie mieć klasyfikację podklasyczną (i tylko zastępowaną) z testów jednostkowych.@DeprecatedSinceApi
(b/37116481): wskazuje, że metoda (lub klasa lub pole) z adnotacjami jest częścią biblioteki backendu dla interfejsu API platformy, która nie jest już potrzebna na danym poziomie interfejsu API.@EmptySuper
: wskazuje, że ta metoda jest zdefiniowana jako pusta, więc w przypadku zastępowania nie musisz jej wywoływać (a w rzeczywistości nie należy jej używać, na przykład może zawierać sprawdzanie zgodności wstecznej).
Wersja 1.4.0-alfa01
15 grudnia 2021 roku
Aplikacja androidx.annotation:annotation:1.4.0-alpha01
została zwolniona. Wersja 1.4.0-alpha01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Adnotacja
RestrictTo
została przeniesiona do źródeł Kotlin (Ia6336)
Wersja 1.3.0
Wersja 1.3.0
3 listopada 2021 r.
Aplikacja androidx.annotation:annotation:1.3.0
została zwolniona. Wersja 1.3.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 1.2.0
- Adnotacja
@Discouraged
do oznaczania interfejsów API, których nie można wycofać, ale mają znaczny wpływ na wydajność i nie powinny być wywoływane w normalnym kodzie produkcyjnym - Adnotacja
@Context
do oznaczania ogólnego kontekstu, aby deweloperzy mogli łatwiej przejść na nowe interfejsy API - Adnotacja
@GravityInt
do oznaczania elementów zawierających wartości grawitacji ułożone w liczbach całkowitych - Wycofano atrybut
@InspectableProperty
na rzecz zasady@Attribute
w przypadku:androidx.resourceinspection
Wersja 1.3.0-rc01
27 października 2021 roku
Aplikacja androidx.annotation:annotation:1.3.0-rc01
została zwolniona. Wersja 1.3.0-rc01 zawiera te zatwierdzenia.
Wersja 1.3.0-beta01
29 września 2021 r.
Aplikacja androidx.annotation:annotation:1.3.0-beta01
została zwolniona. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Wymagaj wyjaśnienia w polu „message” w przypadku @Discouraged. (I3390f)
- Dodanie adnotacji @Discouraged do oznaczania elementów, które są odradzane. (Ib2549)
- Pokazuj adnotację RestrictTo w wyskakującym okienku dokumentacji Studio (Ie8e1a, b/183134648)
Poprawki błędów
- Dodaj adnotacje kontekstowe, aby oznaczyć ogólne konteksty, aby deweloperzy mogli łatwiej przejść na nowe interfejsy API. (IE581a)
Wersja 1.3.0-alfa01
24 marca 2021 r.
Aplikacja androidx.annotation:annotation:1.3.0-alpha01
została zwolniona. Wersja 1.3.0-alpha01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Wycofano atrybut
@InspectableProperty
na rzecz atrybutu@Attribute
w wersjiandroidx.resourceinspection
. (Ic0eff) - Dodano adnotację
@GravityInt
do oznaczania elementów zawierających wartości grawitacji ułożone w liczbach całkowitych. (Ifcaa4, b/180620048)
Adnotacja – wersja eksperymentalna 1.4
Wersja 1.4.1
3 kwietnia 2024 r.
Aplikacja androidx.annotation:annotation-experimental:1.4.1
została zwolniona. Wersja 1.4.1 zawiera te zatwierdzenia.
Poprawki błędów
- Napraw użycie
isKotlin
, aby uniknąć przypadkowego aktywowania kontroliRequiresOptIn
w plikach Kotlin. (I2d8c1f)
Wersja 1.4.0
24 stycznia 2024 r.
Aplikacja androidx.annotation:annotation-experimental:1.4.0
została zwolniona. Wersja 1.4.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 1.3.0
- Dodaj obsługę wieloplatformowej Kotlin
- Popraw zgodność z Kotlin 2.0
- Wyświetlaj ostrzeżenia dotyczące użycia w Javie eksperymentalnych właściwości Kotlin z adnotacjami (I8bd43)
- Napraw umieszczanie adnotacji autokorekty w metodach Kotlin (Id7a41)
Wersja 1.4.0-rc01
10 stycznia 2024 r.
Aplikacja androidx.annotation:annotation-experimental:1.4.0-rc01
została zwolniona. Wersja 1.4.0-rc01 nie zawiera żadnych zmian od poprzedniej wersji.
Wersja 1.4.0-beta01
13 grudnia 2023 r.
Aplikacja androidx.annotation:annotation-experimental:1.4.0-beta01
została zwolniona. Nie wprowadziliśmy żadnych zmian od poprzedniej wersji.
Wersja 1.4.0-alfa01
29 listopada 2023 r.
Aplikacja androidx.annotation:annotation-experimental:1.4.0-alpha01
została zwolniona. Wersja 1.4.0-alpha01 zawiera te zatwierdzenia.
Poprawki błędów
- Tymczasowo usuń sugestie autopoprawek na poziomie zajęć, aby obejść problem z b/301598518. (Id98b2).
- Wyświetlaj ostrzeżenia dotyczące użycia w Javie eksperymentalnych właściwości Kotlin z adnotacjami (I8bd43)
- Napraw umieszczanie adnotacji autokorekty w metodach Kotlin (Id7a41)
Wersja 1.4.0-dev01
8 lutego 2023 r.
Aplikacja androidx.annotation:annotation-experimental:1.4.0-dev01
została zwolniona. Wersja 1.4.0-dev01 zawiera te zatwierdzenia.
- Eksperyment dotyczący adnotacji został włączony na wielu platformach w ramach wersji przedpremierowej dla programistów w wersji 1.4.0-dev01 w usłudze Kotlin.
Adnotacja – eksperymentalna wersja 1.3.1
Wersja 1.3.1
21 czerwca 2023 r.
Aplikacja androidx.annotation:annotation-experimental:1.3.1
została zwolniona. Wersja 1.3.1 zawiera te zatwierdzenia.
Poprawki błędów
- Podczas stosowania autokorekty lintowania umieść adnotację na początku listy modyfikatorów. (b/251172715)
- Używaj sprawdzania lintowań, aby odradzać używanie
androidx.annotation.RequiresOptIn
w źródłach Kotlin (b/241097743)
Adnotacja – eksperymentalna wersja 1.3.0
Wersja 1.3.0
7 września 2022 roku
Aplikacja androidx.annotation:annotation-experimental:1.3.0
została zwolniona. Wersja 1.3.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 1.2.0
- Dodano obsługę użycia
@androidx.annotation.OptIn
na poziomie pakietu (I24d58) - Przeniesiono zależność stdlib Kotlin do typu API, a nie tylko do kompilacji. Oznacza to, że wszyscy klienci biblioteki adnotacji-eksperymentalnej będą w swoich zależnościach przechodnich zawierać standardową bibliotekę Kotlin.
Wersja 1.3.0-rc01
24 sierpnia 2022 r.
Aplikacja androidx.annotation:annotation-experimental:1.3.0-rc01
została zwolniona. Wersja 1.3.0-rc01 zawiera te zatwierdzenia.
- Brak zmian w stosunku do poprzedniej wersji. Implementacja została wstrzymana w przypadku RC.
Wersja 1.3.0-beta01
10 sierpnia 2022 r.
Aplikacja androidx.annotation:annotation-experimental:1.3.0-beta01
została zwolniona. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.
- Bez zmian w porównaniu z wersją alfa. Ta biblioteka jest ustabilizowana na potrzeby wersji beta.
Wersja 1.3.0-alfa01
27 lipca 2022 roku
Aplikacja androidx.annotation:annotation-experimental:1.3.0-alpha01
została zwolniona. Wersja 1.3.0-alpha01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Dodano obsługę użycia
@androidx.annotation.OptIn
na poziomie pakietu (I24d58)
Adnotacja – eksperymentalna wersja 1.2.0
Wersja 1.2.0
15 grudnia 2021 roku
Aplikacja androidx.annotation:annotation-experimental:1.2.0
została zwolniona. Wersja 1.2.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 1.1.0
Ta biblioteka jest teraz kierowana na język Java 8.
Wersja 1.2.0-rc01
Grudzień 1, 2021
Aplikacja androidx.annotation:annotation-experimental:1.2.0-rc01
została zwolniona. Wersja 1.2.0-rc01 zawiera te zatwierdzenia.
Bez zmian w stosunku do wersji beta.
Wersja 1.2.0-beta01
17 listopada 2021 r.
Aplikacja androidx.annotation:annotation-experimental:1.2.0-beta01
została zwolniona. Wersja 1.2.0-beta01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
Interfejsy API zostały udostępnione do wersji beta.
Adnotacja – wersja eksperymentalna 1.2.0-alfa01
30 czerwca 2021 r.
Aplikacja androidx.annotation:annotation-experimental:1.2.0-alpha01
została zwolniona. Wersja 1.2.0-alpha01 zawiera te zatwierdzenia.
Nowe funkcje
- Biblioteka jest teraz kierowana na język Java 8
Wersja 1.2.0
Wersja 1.2.0
24 marca 2021 r.
Aplikacja androidx.annotation:annotation:1.2.0
została zwolniona. Wersja 1.2.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 1.1.0
- Dodano adnotację
@ChecksSdkIntAtLeast
, która może służyć do identyfikowania metod lub pól używanych do blokowania dostępu na poziomie pakietu SDK i sprawdzania lintNewApi
. - Dodano adnotację
@DoNotInline
, która jest powiązana z regułą ProGuard, która uniemożliwia wstawianie członków podczas optymalizacji. - Różne adnotacje są teraz opatrzone adnotacją
@Documented
, aby zapewnić, że będą one wyświetlane w dokumentacji dla wspierających.
Wersja 1.2.0-rc01
24 lutego 2021 r.
Aplikacja androidx.annotation:annotation:1.2.0-rc01
została zwolniona. Wersja 1.2.0-rc01 zawiera te zatwierdzenia.
Wersja 1.2.0-beta01
13 stycznia 2021 r.
Aplikacja androidx.annotation:annotation:1.2.0-beta01
została zwolniona. Wersja 1.2.0-beta01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Nowa adnotacja
@DoNotInline
, która nakazuje optymalizatorom kodu (np. Proguard, R8) niewbudowanie metody z adnotacjami. (I3dfe8, b/141326133)
Wersja 1.2.0-alfa01
14 maja 2020 r.
Aplikacja androidx.annotation:annotation:1.2.0-alpha01
została zwolniona. Wersja 1.2.0-alpha01 zawiera te zatwierdzenia.
Nowe funkcje
- Dodano adnotację
@ChecksSdkIntAtLeast
. Dzięki temu Androidx i użytkownicy dodają adnotacje do metod i pól reprezentujących kontrolęSDK_INT
. (I89a54, b/120255046)
Adnotacja – eksperymentalna wersja 1.1.0
Wersja 1.1.0
7 kwietnia 2021 r.
Aplikacja androidx.annotation:annotation-experimental:1.1.0
została zwolniona. Wersja 1.1.0 zawiera te zatwierdzenia.
Ważne zmiany od wersji 1.0.0
- Eksperymentalne adnotacje Jetpack w wersji Kotlin zostały napisane od nowa, aby zapewnić obsługę wielu klas znaczników i ulepszyć obsługę wycofywania aplikacji.
- Adnotacje
RequiresOptIn
iOptIn
zostały dodane, aby zachować spójność z Kotlin. AdnotacjeExperimental
iUsesExperimental
zostały wycofane.
Wersja 1.1.0-rc02
24 marca 2021 r.
Aplikacja androidx.annotation:annotation-experimental:1.1.0-rc02
została zwolniona. Wersja 1.1.0-rc02 zawiera te zatwierdzenia.
Poprawki błędów
- Dodano reguły ProGuard, aby mieć pewność, że optymalizacja kodu nie ostrzega o brakujących metaadnotacjach Kotlin.
Wersja 1.1.0-rc01
10 marca 2021 r.
Aplikacja androidx.annotation:annotation-experimental:1.1.0-rc01
została zwolniona. Wersja 1.1.0-rc01 zawiera te zatwierdzenia.
Brak zmian od poprzedniej wersji beta.
Wersja 1.1.0-beta01
27 stycznia 2021 r.
Aplikacja androidx.annotation:annotation-experimental:1.1.0-beta01
została zwolniona. Wersja 1.1.0-beta01 zawiera te zatwierdzenia.
Zmiany w interfejsie API
- Wariant androidx adnotacji eksperymentalnej został wycofany, aby zapewnić spójność z Kotlinem. Zastąpiła ją wariantem na AndroidaX adnotacji WymagajsOptIn, a linter w języku Java został zaktualizowany, aby obsługiwał zarówno nową adnotację Kotlin, jak i nową wersję Androidax. (I52495, b/151331381)
Wersja 1.1.0-alfa01
22 lipca 2020 r.
Aplikacja androidx.annotation:annotation-experimental:1.1.0-alpha01
została zwolniona. Wersja 1.1.0-alpha01 zawiera te zatwierdzenia.
Nowe funkcje
- Eksperymentalna biblioteka adnotacji została napisana w Kotlin, ale nie wymaga dodawania biblioteki standardowej Kotlin jako zależności. Zawiera plik Proguard, który umożliwia usunięcie niepotrzebnych metadanych Kotlin z projektów używających wyłącznie języka programowania Java.
@UseExperimental
obsługuje teraz wiele klas znaczników (aosp/1185577, b/145137892)
Adnotacja – eksperymentalna wersja 1.0.0
Adnotacja – eksperymentalna wersja 1.0.0
7 listopada 2019 r.
androidx.annotation:annotation-experimental:1.0.0
i androidx.annotation:annotation-experimental-lint:1.0.0
są dostępne bez zmian od 1.0.0-rc01
. Wersja 1.0.0 zawiera te zatwierdzenia.
Główne funkcje wersji 1.0.0
- Egzekwowanie semantyki Kotlin
@Experimental
w kodzie źródłowym Javy na podstawie projektu - Adnotacje w Javie, które zapewniają zachowanie równoważne z adnotacjami
@Experimental
i@UseExperimental
Kotlin, bez konieczności uzależniania od Kotlin
Adnotacja – wersja eksperymentalna 1.0.0-rc01
23 października 2019 r.
Opublikowano androidx.annotation:annotation-experimental:1.0.0-rc01
i androidx.annotation:annotation-experimental-lint:1.0.0-rc01
. Wersja 1.0.0-rc01 zawiera te zatwierdzenia.
Znane problemy
Jeśli używasz stabilnej wersji Studio 3.5, ostrzeżenia z @Experimental
wykrywacza lintowania wykorzystania nie są wyświetlane w IDE w przypadku nieprawidłowego użycia adnotacji Kotlin @Experimental
w języku Java. Zobacz b/140640322.
Adnotacja – wersja eksperymentalna 1.0.0-beta01
9 października 2019 r.
Wersje androidx.annotation:annotation-experimental:1.0.0-beta01
i androidx.annotation:annotation-experimental-lint:1.0.0-beta01
zostały opublikowane bez zmian od wersji 1.0.0-alpha01
. Wersja 1.0.0-beta01 zawiera te zatwierdzenia.
Adnotacja – wersja eksperymentalna 1.0.0-alfa01
18 września 2019 r.
Opublikowano androidx.annotation:annotation-experimental:1.0.0-alpha01
i androidx.annotation:annotation-experimental-lint:1.0.0-alpha01
. To są zobowiązania zawarte w adnotacji i eksperymencie 1.0.0-alpha01
oraz zobowiązania zawarte w adnotacji-experimental-lint 1.0.0-alpha01
Nowe funkcje
Biblioteka adnotacji Jetpack Experimental zawiera zgodną z Javą implementację eksperymentalnych znaczników interfejsu API firmy Kotlin. Artefakt
-lint
umożliwia implementację ograniczeń użytkowania w eksperymentach opartych na Lint i egzekwuje ograniczenia dotyczące użycia natywnych, eksperymentalnych znaczników interfejsu API w języku Java.Gdy używasz artefaktu
annotation-experimental
jako zależności, reguły Lint dostarczane przez ten artefaktannotation-experimental-lint
są egzekwowane automatycznie.
Wersja 1.1.0
Wersja 1.1.0
5 czerwca 2019 r.
Wersja androidx.annotation:annotation:1.1.0
została opublikowana bez zmian z wersji 1.1.0-rc01.
Wersja 1.1.0-rc01
7 maja 2019 r.
Opublikowano androidx.annotation:annotation:1.1.0-rc01
bez zmian z 1.1.0-beta01
. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.
Wersja 1.1.0-beta01
3 kwietnia 2019 r.
Aplikacja androidx.annotation:annotation:1.1.0-beta01
została zwolniona. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.
Nowe funkcje
- Nowa adnotacja
@InspectableProperty
do obsługi nowych interfejsów API inspekcji widoków dodanych w Androidzie 10. Tę adnotację można stosować do metod pobierania w widokach lub innych elementach interfejsu. Narzędzia do generowania kodu mogą za jego pomocą tworzyć obiekty towarzyszące, które mapują nazwy właściwości i przypisują identyfikatory do wartości właściwości bez zbędnego nakładu pracy.
Zmiany w interfejsie API
- Zmiana powodująca niezgodność:
@ContentView
została zmieniona na adnotację konstruktora, a wartość@LayoutRes
została usunięta. Klasy, które mają obsługiwać adnotacje@ContentView
, powinny dodać tę adnotację do konstruktora, który przyjmuje parametr@LayoutRes int
. Rozwiązuje to problem z używaniem adnotacji w modułach biblioteki. (b/128352521)
Wersja 1.1.0-alfa02
13 marca 2019 r.
Aplikacja androidx.annotation:annotation:1.1.0-alpha02
została zwolniona. Pełną listę zatwierdzeń zawartych w tej wersji znajdziesz tutaj.
Nowe funkcje
- Nowy zakres ograniczeń interfejsu API:
RestrictTo.Scope.LIBRARY_GROUP_PREFIX
. Ogranicza wykorzystanie do kodu w ramach pakietów, których grupy mają ten sam prefiks grupy bibliotek do ostatniego.
(kropka). Na przykład bibliotekifoo.bar:lib1
ifoo.baz:lib2
mają ten sam prefiksfoo
, dlatego mogą używać własnych interfejsów API, które są ograniczone do tego zakresu. Podobnie w przypadkucom.foo.bar:lib1
icom.foo.baz:lib2
prefikscom.foo.
może udostępniać interfejsy API ograniczone do tego zakresu. Bibliotekacom.bar.qux:lib3
nie będzie jednak mogła korzystać z interfejsu API z ograniczeniami, ponieważ ma ona tylko prefikscom.
, a nie aż do ostatniego.
(kropka).
Wersja 1.1.0-alfa01
30 stycznia 2019 r.
Aplikacja androidx.annotation:annotation 1.1.0-alpha01
została zwolniona.
Nowe funkcje
- Dodaliśmy adnotację
@ContentView
, która pozwala wskazać plik XML układu, który należy powiększyć. Ta funkcja jest obsługiwana wComponentActivity
w wersji1.0.0-alpha04
iFragment
w wersji1.1.0-alpha04
jako alternatywa dla użyciasetContentView()
lub zastąpieniaonCreateView()
. (Aosp/837619)
Wersja 1.0.2
Wersja 1.0.2
25 lutego 2019 r.
Aplikacja androidx.annotation:annotation 1.0.2
została zwolniona.
Poprawki błędów
- Popraw reguły R8/ProGuard, które są osadzone w słoiku. Nieprawidłowe odwoływanie się do starych typów
android.support.annotation
zamiastandroidx.annotation
. Uwaga: jeśli nie używaszgetDefaultProguardFile
, miałoby to wpływ na kompilacje, ponieważ te reguły domyślne zawierały też prawidłowe reguły dla obu pakietów. (Aosp/891685) - Dodaj regułę R8/ProGuard, która wyraźnie zachowuje adnotację @Keep. Dzięki temu ProGuard nie usuwa adnotacji z typów, zanim zachowa ona jej semantykę. Uwaga: jeśli nie używasz
getDefaultProguardFile
, miałoby to wpływ na kompilacje, ponieważ te reguły domyślne zawierały też prawidłowe reguły dla obu pakietów. (Aosp/903818)