Adnotacja
Ta tabela zawiera wszystkie artefakty w grupie androidx.annotation
.
Artefakt | Wersja stabilna | Kandydat do wydania | Wersja Beta | Wydanie alfa |
---|---|---|---|---|
adnotacja | 1.8.0 | - | - | 1.9.0-alfa01 |
eksperymentalna-adnotacja | 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:
Odlotowe
dependencies { implementation "androidx.annotation:annotation:1.8.0" // 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.8.0") // 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 odkryjesz nowe wydania lub masz pomysły na ulepszenie tej biblioteki. Zanim utworzysz nową bibliotekę, przejrzyj istniejące problemy w tej bibliotece. Możesz oddać swój głos do istniejącego problemu, klikając przycisk gwiazdki.
Więcej informacji znajdziesz w dokumentacji narzędzia do śledzenia problemów.
Wersja 1.9
Wersja 1.9.0-alpha01
26 czerwca 2024 r.
Usługa androidx.annotation:annotation-*:1.9.0-alpha01
została zwolniona. Wersja 1.9.0-alfa01 zawiera te zatwierdzenia.
Treści tłumaczone przez użytkowników zewnętrznych
- Dodano obsługę celu wieloplatformowego
linuxArm64
(dziękujemy Jake'owi Whartonowi!)
Wersja 1.8
Wersja 1.8.0
14 maja 2024 r.
Usługa androidx.annotation:annotation-*:1.8.0
została zwolniona. Wersja 1.8.0 zawiera te zatwierdzenia.
Ważne zmiany wprowadzone od wersji 1.7.0
- Dodano adnotację
@ReplaceWith
do szybkiego zamienników wycofanych interfejsów API - Adnotacja
@MainThread
została przeniesiona do wspólnego zbioru źródłowego.
Wersja 1.8.0-rc01
1 maja 2024 r.
Usługa androidx.annotation:annotation-*:1.8.0-rc01
została zwolniona. Wersja 1.8.0-rc01 nie zawiera żadnych zmian od poprzedniej wersji beta.
Wersja 1.8.0-beta02
17 kwietnia 2024 r.
Usługa 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.
Usługa 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 w interfejsie API, ale powiązane z nią sprawdzanie lintowania z funkcją autopoprawki nie zostało jeszcze wysłane
Wersja 1.8.0-alpha02
20 marca 2024 r.
Wersja androidx.annotation:annotation-*:1.8.0-alpha02
została udostępniona bez istotnych zmian. Wersja 1.8.0-alfa02 zawiera te zatwierdzenia.
Wersja 1.8.0-alpha01
21 lutego 2024 r.
Usługa androidx.annotation:annotation-*:1.8.0-alpha01
została zwolniona. Wersja 1.8.0-alfa01 zawiera te zatwierdzenia.
Zmiany interfejsu API
- Dodaliśmy adnotację
@ReplaceWith
, aby umożliwić ekspresowe zamienniki wycofanych interfejsów API. (I38db3, b/322373864)
Treści tłumaczone 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.
Usługa androidx.annotation:annotation-*:1.7.1
została zwolniona. Wersja 1.7.1 zawiera te zatwierdzenia.
Poprawki błędów
- Podczas wstawiania domyślnej zależności platformy użyj zakresu
compile
. (I4958f)
Wersja 1.7.0
6 września 2023 r.
Usługa 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.
- Możesz teraz używać adnotacji w projektach KMM. Pamiętaj, że kierowanie adnotacji na platformy inne niż Android jest nadal w fazie eksperymentalnej, ale postanowiliśmy połączyć ich wersje, by ułatwić deweloperom ich wypróbowanie. W szczególności niektóre adnotacje mogą pojawiać się między kodem wspólnym a konkretnym dla danej platformy w fazie alfa, gdy będziemy finalizować granice.
Wersja 1.7.0-rc01
23 sierpnia 2023 r.
Usługa androidx.annotation:annotation-*:1.7.0-rc01
została zwolniona. Wersja 1.7.0-rc01 zawiera te zatwierdzenia.
Nie zawiera ona żadnych zmian w porównaniu z poprzednią wersją beta.
Wersja 1.7.0-beta01
9 sierpnia 2023 r.
Usługa androidx.annotation:annotation-*:1.7.0-beta01
została zwolniona. Wersja 1.7.0-beta01 zawiera te zatwierdzenia.
Nowe funkcje
- Ustabilizowane interfejsy API na potrzeby wersji
Wersja 1.7.0-alpha03
26 lipca 2023 r.
Usługa androidx.annotation:annotation-*:1.7.0-alpha03
została zwolniona. Wersja 1.7.0-alfa03 zawiera te zatwierdzenia.
Poprawki błędów
- Publikacja Maven POM zawiera jako zależność domyślny artefakt wieloplatformowy kierowany na JVM
Wersja 1.7.0-alpha02
24 marca 2023 r.
Usługa androidx.annotation:annotation-*:1.7.0-alpha02
została zwolniona.
Poprawki błędów
- Usunęliśmy ograniczenia zależności z artefaktów Maven, aby obejść problem z kompilacją w natywnych miejscach docelowych Kotlin (b/274786186, KT-57531).
Wersja 1.7.0-alpha01
22 marca 2023 r.
Usługa androidx.annotation:annotation-*:1.7.0-alpha01
została zwolniona. Wersja 1.7.0-alfa01 zawiera te zatwierdzenia.
Nowe funkcje
- Obejmuje wieloplatformowe artefakty Kotlin kierowane na platformy iOS, Linux i macOS.
- Możesz teraz używać adnotacji w projektach KMM. Pamiętaj, że kierowanie adnotacji na platformy inne niż Android jest nadal w fazie eksperymentalnej, ale postanowiliśmy połączyć ich wersje, by ułatwić deweloperom ich wypróbowanie. W szczególności niektóre adnotacje mogą pojawiać się między kodem wspólnym a konkretnym dla danej platformy w fazie alfa, gdy będziemy finalizować granice.
Wersja 1.6
Wersja 1.6.0
22 lutego 2023 roku
androidx.annotation:annotation:1.6.0
i androidx.annotation:annotation-jvm:1.6.0
zostały udostępnione. Wersja 1.6.0 zawiera te zatwierdzenia.
Ważne zmiany wprowadzone od wersji 1.5.0
- Dodaje adnotację
@RequiresExtension
, aby wskazać, że interfejs API wymaga określonej wersji określonego pakietu SDK rozszerzenia (I5e4fe) - Przekonwertowano bibliotekę adnotacji, tworząc wieloplatformowy łańcuch narzędzi Kotlin (I3be8d)
Wersja 1.6.0-rc01
8 lutego 2023 r.
androidx.annotation:annotation:1.6.0-rc01
i androidx.annotation:annotation-jvm:1.6.0-rc01
zostały udostępnione. Wersja 1.6.0-rc01 zawiera te zatwierdzenia.
- Adnotacja została ustabilizowana w wersji 1.6.0-rc01.
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 zwolnione bez zmian od 1.6.0-alpha01
.
Wersja 1.6.0-alpha01
11 stycznia 2023 r.
Usługa androidx.annotation:annotation-*:1.6.0-alpha01
została zwolniona. Wersja 1.6.0-alfa01 zawiera te zatwierdzenia.
Wersja 1.6.0-dev01
8 lutego 2023 r.
Usługa androidx.annotation:annotation-*:1.6.0-dev01
została zwolniona. Wersja 1.6.0-dev01 zawiera te zatwierdzenia.
- Dzięki adnotacjom funkcja Kotlin w wersji 1.6.0-dev01 została udostępniona na wielu platformach w wersji testowej dla programistów.
Nowe funkcje
- Dodaje adnotację
@RequiresExtension
, aby wskazać, że interfejs API wymaga określonej wersji pakietu SDK danego rozszerzenia. (I5e4fe) - Przekonwertowano bibliotekę adnotacji, tworząc wieloplatformowy łańcuch narzędzi Kotlin (I3be8d)
Wersja 1.5.0
Wersja 1.5.0
21 września 2022 r.
Usługa androidx.annotation:annotation:1.5.0
została zwolniona. Wersja 1.5.0 zawiera te zatwierdzenia.
Ważne zmiany wprowadzone od wersji 1.4.0
- Biblioteka adnotacji została w pełni przeniesiona do źródeł Kotlin, co zaowocowało obsługą docelowych witryn użycia specyficznych dla Kotlin i innych funkcji adnotacji zgodnych z Kotlin.
Wersja 1.5.0-rc01
7 września 2022 roku
Usługa androidx.annotation:annotation:1.5.0-rc01
została zwolniona. Wersja 1.5.0-rc01 zawiera te zatwierdzenia.
- Brak zmian w stosunku do poprzedniej wersji beta (1.5.0).
Wersja 1.5.0-beta01
24 sierpnia 2022 r.
Usługa androidx.annotation:annotation:1.5.0-beta01
została zwolniona. Wersja 1.5.0-beta01 zawiera te zatwierdzenia.
- Brak zmian w porównaniu z poprzednią wersją. Powierzchnia interfejsu API została zablokowana dla wersji beta.
Wersja 1.5.0-alpha02
10 sierpnia 2022 r.
Usługa androidx.annotation:annotation:1.5.0-alpha02
została zwolniona. Wersja 1.5.0-alfa02 zawiera te zatwierdzenia.
- Brak zmian od poprzedniej wersji alfa.
Wersja 1.5.0-alpha01
27 lipca 2022 roku
Usługa androidx.annotation:annotation:1.5.0-alpha01
została zwolniona. Wersja 1.5.0-alfa01 zawiera te zatwierdzenia.
Nowe funkcje
- Biblioteka adnotacji została w pełni przeniesiona do źródeł Kotlin, co zaowocowało obsługą docelowych witryn użycia specyficznych dla Kotlin i innych funkcji adnotacji zgodnych z Kotlin.
Wersja 1.4.0
Wersja 1.4.0
15 czerwca 2022 r.
Usługa androidx.annotation:annotation:1.4.0
została zwolniona. Wersja 1.4.0 zawiera te zatwierdzenia.
Ważne zmiany wprowadzone od wersji 1.3.0
- Rozszerzenie
@RestrictTo
zostało przeniesione do źródeł Kotlin i obsługuje teraz witrynę użycia@file
. W związku z tym biblioteka Adnotacji bazuje na standardowej bibliotece Kotlin. @ReturnThis
(b/140249763): gwarantuje, że metody zastępowania w tej metodzie muszą zwracać tę samą instancję (przeznaczone dla konstruktorów itp.)@OpenForTesting
(b/141539024): Klasy i metody Kotlin oznaczone jako „otwarte” można opatrzyć adnotacją za pomocą adnotacji. Lint zapewni, że w testach jednostkowych tylko ta klasa zostanie podklasa (i tylko metody zostaną zastąpione)@DeprecatedSinceApi
(b/37116481): oznacza, ż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 przy zastępowaniu nie trzeba jej wywoływać (a w rzeczywistości nie należy jej wywoływać, ponieważ może na przykład zawierać sprawdzanie zgodności wstecznej).
Wersja 1.4.0-rc01
1 czerwca 2022 r.
Usługa androidx.annotation:annotation:1.4.0-rc01
została zwolniona. Wersja 1.4.0-rc01 zawiera te zatwierdzenia.
- Wdrożenie interfejsu API i jego funkcji zostało zakończone.
Wersja 1.4.0-beta01
18 maja 2022 r.
Usługa androidx.annotation:annotation:1.4.0-beta01
została zwolniona. Wersja 1.4.0-beta01 zawiera te zatwierdzenia.
- Brak zmian od ostatniej wersji alfa. Dostęp do interfejsu API został zablokowany dla wersji beta.
Wersja 1.4.0-alpha02
9 lutego 2022 r.
Usługa androidx.annotation:annotation:1.4.0-alpha02
została zwolniona. Wersja 1.4.0-alfa02 zawiera te zatwierdzenia.
Nowe funkcje
Dodano adnotacje
@ReturnThis
,@OpenForTesting
,@EmptySuper
i@DeprecatedSinceApi
. (21946a2)@ReturnThis
(b/140249763): gwarantuje, że metody zastępowania w tej metodzie muszą zwracać tę samą instancję (przeznaczone dla konstruktorów itp.).@OpenForTesting
(b/141539024): do tej adnotacji można dodać adnotacje o klasach i metodach Kotlin oznaczonych jako „otwarte”. Lint sprawi, że z testów jednostkowych do tej klasy zostanie przypisana tylko podklasa (i tylko metody zostaną zastąpione)@DeprecatedSinceApi
(b/37116481): oznacza, ż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 przy zastępowaniu nie trzeba jej wywoływać (a w rzeczywistości nie należy jej wywoływać, ponieważ może na przykład zawierać sprawdzanie zgodności wstecznej).
Wersja 1.4.0-alpha01
15 grudnia 2021 roku
Usługa androidx.annotation:annotation:1.4.0-alpha01
została zwolniona. Wersja 1.4.0-alfa01 zawiera te zatwierdzenia.
Zmiany interfejsu API
- Przeniesiono adnotacje
RestrictTo
do źródeł Kotlin (Ia6336)
Wersja 1.3.0
Wersja 1.3.0
3 listopada 2021 r.
Usługa androidx.annotation:annotation:1.3.0
została zwolniona. Wersja 1.3.0 zawiera te zatwierdzenia.
Ważne zmiany wprowadzone od wersji 1.2.0
- Adnotacja
@Discouraged
do oznaczania interfejsów API, których nie można w uzasadniony sposób wycofać, ale mają one znaczny negatywny wpływ na wydajność i nie powinny być wywoływane w zwykłym kodzie produkcyjnym - Adnotacja
@Context
do oznaczania ogólnych kontekstów, co ułatwia programistom migrację do nowych interfejsów API - Adnotacja
@GravityInt
do oznaczania elementów zawierających wartości grawitacji ułożonych w liczby całkowite - Wycofano:
@InspectableProperty
na rzecz@Attribute
w przypadku:androidx.resourceinspection
Wersja 1.3.0-rc01
27 października 2021 roku
Usługa 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.
Usługa androidx.annotation:annotation:1.3.0-beta01
została zwolniona. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.
Zmiany interfejsu API
- Wymagaj wyjaśnienia w polu „message” w przypadku @Odradzane. (I3390f)
- dodawanie adnotacji @Odradzane w celu oznaczania elementów, których odradzamy; (IB2549)
- Pokazuj adnotację RestrictTo w wyskakującym okienku z dokumentami w Studio (Ie8e1a, b/183134648)
Poprawki błędów
- Dodaj adnotację kontekstową, aby oznaczyć ogólne konteksty i ułatwić programistom migrację do nowych interfejsów API. (IE581a).
Wersja 1.3.0-alpha01
24 marca 2021 r.
Usługa androidx.annotation:annotation:1.3.0-alpha01
została zwolniona. Wersja 1.3.0-alfa01 zawiera te zatwierdzenia.
Zmiany interfejsu API
- Wycofano
@InspectableProperty
na rzecz@Attribute
wandroidx.resourceinspection
. (IC0Eff) - Dodaliśmy adnotację
@GravityInt
do oznaczania elementów zawierających wartości grawitacji ujętych w liczby całkowite. (Ifcaa4, b/180620048)
Adnotacja-eksperymentalna wersja 1.4
Wersja 1.4.1
3 kwietnia 2024 r.
Usługa androidx.annotation:annotation-experimental:1.4.1
została zwolniona. Wersja 1.4.1 zawiera te zatwierdzenia.
Poprawki błędów
- Popraw użycie funkcji
isKotlin
, aby uniknąć przypadkowego uruchomienia funkcjiRequiresOptIn
w plikach Kotlin. (I2d8c1f).
Wersja 1.4.0
24 stycznia 2024 r.
Usługa androidx.annotation:annotation-experimental:1.4.0
została zwolniona. Wersja 1.4.0 zawiera te zatwierdzenia.
Ważne zmiany wprowadzone od wersji 1.3.0
- Dodanie obsługi wieloplatformowej platformy Kotlin
- Popraw zgodność z Kotlin 2.0
- Pokazuj ostrzeżenia o zastosowaniu w języku Java właściwości Kotlin z adnotacjami eksperymentalnymi (I8bd43)
- Naprawianie umieszczenia adnotacji z autokorektą w metodach Kotlin (Id7a41)
Wersja 1.4.0-rc01
10 stycznia 2024 r.
Usługa 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.
Usługa androidx.annotation:annotation-experimental:1.4.0-beta01
została zwolniona. Nic się nie zmieniło od poprzedniej wersji.
Wersja 1.4.0-alpha01
29 listopada 2023 r.
Usługa androidx.annotation:annotation-experimental:1.4.0-alpha01
została zwolniona. Wersja 1.4.0-alfa01 zawiera te zatwierdzenia.
Poprawki błędów
- Tymczasowo usuń sugestie autopoprawek na poziomie zajęć, aby obejść problem b/301598518. (Id98b2).
- Pokazuj ostrzeżenia o zastosowaniu w języku Java właściwości Kotlin z adnotacjami eksperymentalnymi (I8bd43)
- Naprawianie umieszczenia adnotacji z autokorektą w metodach Kotlin (Id7a41)
Wersja 1.4.0-dev01
8 lutego 2023 r.
Usługa androidx.annotation:annotation-experimental:1.4.0-dev01
została zwolniona. Wersja 1.4.0-dev01 zawiera te zatwierdzenia.
- Eksperymentalne adnotacje umożliwiły korzystanie z wieloplatformowej wersji Kotlin w wersji testowej 1.4.0-dev01 dla programistów.
Adnotacja-eksperymentalna wersja 1.3.1
Wersja 1.3.1
21 czerwca 2023 r.
Usługa androidx.annotation:annotation-experimental:1.3.1
została zwolniona. Wersja 1.3.1 zawiera te zatwierdzenia.
Poprawki błędów
- Podczas stosowania autokorekty lint umieść adnotację na początku listy modyfikatorów. (b/251172715)
- Użyj sprawdzania lint, aby zniechęcić do używania funkcji
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
Usługa androidx.annotation:annotation-experimental:1.3.0
została zwolniona. Wersja 1.3.0 zawiera te zatwierdzenia.
Ważne zmiany wprowadzone od wersji 1.2.0
- Dodanie obsługi użycia funkcji
@androidx.annotation.OptIn
na poziomie pakietu (I24d58) - Przeniesiono zależność stdlib Kotlin do typu interfejsu API zamiast tylko do kompilowania. Oznacza to, że wszyscy klienci biblioteki Annotation- Experimental będą umieszczać w zależnościach pośrednich bibliotekę standardową Kotlin.
Wersja 1.3.0-rc01
24 sierpnia 2022 r.
Usługa androidx.annotation:annotation-experimental:1.3.0-rc01
została zwolniona. Wersja 1.3.0-rc01 zawiera te zatwierdzenia.
- Bez zmian w porównaniu z poprzednią wersją. Implementacja została zablokowana dla RC.
Wersja 1.3.0-beta01
10 sierpnia 2022 r.
Usługa androidx.annotation:annotation-experimental:1.3.0-beta01
została zwolniona. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.
- Bez zmian w stosunku do wersji alfa. Ta biblioteka została stabilna pod kątem wersji beta.
Wersja 1.3.0-alpha01
27 lipca 2022 roku
Usługa androidx.annotation:annotation-experimental:1.3.0-alpha01
została zwolniona. Wersja 1.3.0-alfa01 zawiera te zatwierdzenia.
Zmiany interfejsu API
- Dodanie obsługi użycia funkcji
@androidx.annotation.OptIn
na poziomie pakietu (I24d58)
Adnotacja-eksperymentalna wersja 1.2.0
Wersja 1.2.0
15 grudnia 2021 roku
Usługa 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
1 grudnia 2021 r.
Usługa 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.
Usługa androidx.annotation:annotation-experimental:1.2.0-beta01
została zwolniona. Wersja 1.2.0-beta01 zawiera te zatwierdzenia.
Zmiany interfejsu API
Interfejsy API zostały dodane do wersji beta.
Adnotacja-eksperymentalna wersja 1.2.0-alfa01
30 czerwca 2021 r.
Usługa androidx.annotation:annotation-experimental:1.2.0-alpha01
została zwolniona. Wersja 1.2.0-alfa01 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.
Usługa 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órej można używać do identyfikowania metod lub pól używanych do bramki dostępu na poziomie SDK i sprawdzania lintowaniaNewApi
. - Dodano adnotację
@DoNotInline
, która jest połączona z regułą ProGuard, aby uniemożliwić wspierającym wstawianie treści podczas optymalizacji. - Różne adnotacje są teraz opatrzone adnotacjami
@Documented
, aby mieć pewność, że będą widoczne w dokumentacji dla wspierających z adnotacjami.
Wersja 1.2.0-rc01
24 lutego 2021 r.
Usługa 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.
Usługa androidx.annotation:annotation:1.2.0-beta01
została zwolniona. Wersja 1.2.0-beta01 zawiera te zatwierdzenia.
Zmiany interfejsu API
- Nowa adnotacja
@DoNotInline
, która instruuje optymalizatorów kodu (np. Proguard, R8), aby nie zawierały metody z adnotacjami. (I3dfe8, b/141326133)
Wersja 1.2.0-alpha01
14 maja 2020 r.
Usługa androidx.annotation:annotation:1.2.0-alpha01
została zwolniona. Wersja 1.2.0-alfa01 zawiera te zatwierdzenia.
Nowe funkcje
- Dodano adnotację
@ChecksSdkIntAtLeast
. Dzięki temu Androidx i użytkownicy będą dodawać adnotacje do metod i pól, które reprezentują kontrolęSDK_INT
. (I89a54, b/120255046)
Adnotacja-eksperymentalna wersja 1.1.0
Wersja 1.1.0
7 kwietnia 2021 r.
Usługa 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 Jetpacka zostały napisane od nowa w Kotlin, tak aby zapewnić obsługę wielu klas znaczników i usprawnioną obsługę wycofywania.
- Dodaliśmy adnotacje
RequiresOptIn
iOptIn
, aby zapewnić zgodność z Kotlinem, a adnotacjeExperimental
iUsesExperimental
zostały wycofane.
Wersja 1.1.0-rc02
24 marca 2021 r.
Usługa androidx.annotation:annotation-experimental:1.1.0-rc02
została zwolniona. Wersja 1.1.0-rc02 zawiera te zatwierdzenia.
Poprawki błędów
- Dodaliśmy reguły ProGuard, aby optymalizacja kodu nie ostrzegała o brakujących metanotatkach Kotlin.
Wersja 1.1.0-rc01
10 marca 2021 r.
Usługa androidx.annotation:annotation-experimental:1.1.0-rc01
została zwolniona. Wersja 1.1.0-rc01 zawiera te zatwierdzenia.
Bez zmian od poprzedniej wersji beta.
Wersja 1.1.0-beta01
27 stycznia 2021 r.
Usługa androidx.annotation:annotation-experimental:1.1.0-beta01
została zwolniona. Wersja 1.1.0-beta01 zawiera te zatwierdzenia.
Zmiany interfejsu API
- Wariant Androidax adnotacji eksperymentalnej został wycofany, aby zapewnić zgodność z narzędziem Kotlin. Zastąpiliśmy ją wariantem Androidax adnotacji RequestsOptIn, a linter obsługujący język Java (dotyczy to zarówno nowej adnotacji Kotlin, jak i nowego wariantu Androidax) został zaktualizowany. (I52495, b/151331381)
Wersja 1.1.0-alpha01
22 lipca 2020 r.
Usługa androidx.annotation:annotation-experimental:1.1.0-alpha01
została zwolniona. Wersja 1.1.0-alfa01 zawiera te zatwierdzenia.
Nowe funkcje
- Eksperymentalna biblioteka adnotacji jest teraz napisana w Kotlin, ale nie wymaga uwzględniania standardowej biblioteki Kotlin jako zależności. Zawiera on plik Proguard, który umożliwia usuwanie zbędnych metadanych Kotlin z projektów wykorzystujących wyłącznie język 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.
Wersje androidx.annotation:annotation-experimental:1.0.0
i androidx.annotation:annotation-experimental-lint:1.0.0
zostały udostępnione bez zmian od 1.0.0-rc01
. Wersja 1.0.0 zawiera te zatwierdzenia.
Główne funkcje 1.0.0
- Egzekwowanie semantyki
@Experimental
Kotlin w kodzie źródłowym Javy w oparciu o Lint - Adnotacje w języku Java, które zapewniają takie samo działanie jak adnotacje
@Experimental
i@UseExperimental
Kotlina bez konieczności uzależnienia się od usługi Kotlin
Adnotacja-eksperymentalna wersja 1.0.0-rc01
23 października 2019 r.
androidx.annotation:annotation-experimental:1.0.0-rc01
i androidx.annotation:annotation-experimental-lint:1.0.0-rc01
zostały udostępnione. Wersja 1.0.0-rc01 zawiera te zatwierdzenia.
Znane problemy
Jeśli używasz stabilnej wersji Studio 3.5, ostrzeżenia z wykrywacza lintowania @Experimental
nie są wyświetlane w IDE o nieprawidłowym użyciu adnotacji w języku Java w kotlin @Experimental
. Zobacz b/140640322.
Adnotacja-eksperymentalna wersja 1.0.0-beta01
9 października 2019 r.
androidx.annotation:annotation-experimental:1.0.0-beta01
i androidx.annotation:annotation-experimental-lint:1.0.0-beta01
zostały udostępnione bez zmian od wersji 1.0.0-alpha01
. Wersja 1.0.0-beta01 zawiera te zatwierdzenia.
Adnotacja-eksperymentalna wersja 1.0.0-alfa01
18 września 2019 r.
androidx.annotation:annotation-experimental:1.0.0-alpha01
i androidx.annotation:annotation-experimental-lint:1.0.0-alpha01
zostały udostępnione. To są zobowiązania uwzględnione w ramach eksperymentów dotyczących adnotacji 1.0.0-alpha01
i obejmują zobowiązania zawarte w ramach adnotacji-experimental-lint 1.0.0-alpha01
Nowe funkcje
Eksperymentalna biblioteka adnotacji Jetpack udostępnia zgodną z Javą implementację eksperymentalnych znaczników interfejsu API Kotlin. Artefakt
-lint
udostępnia opartą na Lint implementację eksperymentalnych ograniczeń użytkowania i egzekwuje ograniczenia dotyczące użycia natywnych znaczników eksperymentalnych interfejsów API Kotlin w języku Java.Gdy używasz artefaktu
annotation-experimental
jako zależności, reguły Lint udostępnione przez artefaktannotation-experimental-lint
są egzekwowane automatycznie.
Wersja 1.1.0
Wersja 1.1.0
5 czerwca 2019 r.
Udostępniono wersję androidx.annotation:annotation:1.1.0
bez zmian w wersji 1.1.0-rc01.
Wersja 1.1.0-rc01
7 maja 2019 r.
Pakiet androidx.annotation:annotation:1.1.0-rc01
został zwolniony bez zmian w stosunku do wersji 1.1.0-beta01
. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.
Wersja 1.1.0-beta01
3 kwietnia 2019 r.
Usługa 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 zastosować do pobierania w widokach lub innych elementach interfejsu. Narzędzia do generowania kodu mogą używać go do tworzenia obiektów towarzyszących, które mapują nazwy właściwości i identyfikatory atrybutów na wartości właściwości bez odbicia.
Zmiany interfejsu API
- Niezbędna zmiana: właściwość
@ContentView
została zmieniona w 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ązano problem związany z używaniem tej adnotacji w modułach biblioteki. (b/128352521)
Wersja 1.1.0-alfa02
13 marca 2019 r.
Usługa 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 pakietach, których grupy mają ten sam prefiks grupy bibliotek do ostatniego.
(kropki). Na przykład bibliotekifoo.bar:lib1
ifoo.baz:lib2
mają wspólny prefiksfoo
, więc mogą używać wzajemnie swoich interfejsów API, które są ograniczone do tego zakresu. Podobnie w przypadkucom.foo.bar:lib1
icom.foo.baz:lib2
używają prefiksucom.foo.
i mogą udostępniać interfejsy API ograniczone do tego zakresu. Bibliotekacom.bar.qux:lib3
nie będzie jednak mogła korzystać z interfejsu API z ograniczonym dostępem, ponieważ współdzieli tylko prefikscom.
, a nie całkowicie do ostatniego.
(kropki).
Wersja 1.1.0-alpha01
30 stycznia 2019 r.
Usługa 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 wyświetlić. Jest to obsługiwane wComponentActivity
w wersjach1.0.0-alpha04
iFragment
w wersji1.1.0-alpha04
jako alternatywa dla użycia odpowiedniosetContentView()
lub zastąpienia danychonCreateView()
. (Aosp/837619).
Wersja 1.0.2
Wersja 1.0.2
25 lutego 2019 r.
Usługa androidx.annotation:annotation 1.0.2
została zwolniona.
Poprawki błędów.
- Popraw reguły R8/ProGuard znajdujące się w pliku jar. Były one nieprawidłowo odwoływane do starych typów zasobów typu
android.support.annotation
zamiastandroidx.annotation
. Uwaga: miałoby to wpływ na kompilacje tylko wtedy, gdy nie używaszgetDefaultProguardFile
, ponieważ reguły domyślne obejmowały również 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 usunie adnotacji z typów, zanim zacznie przestrzegać ich semantyki. Uwaga: miałoby to wpływ na kompilacje tylko wtedy, gdy nie używasz
getDefaultProguardFile
, ponieważ reguły domyślne obejmowały również prawidłowe reguły dla obu pakietów. (Aosp/903818)