Adnotacja

Ta tabela zawiera listę wszystkich artefaktów w grupie androidx.annotation.

Deklarowanie zależności

Aby dodać zależność od adnotacji, musisz dodać do projektu repozytorium Google Maven. Więcej informacji znajdziesz w repozytorium Maven Google.

Dodaj zależności dotyczące potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

dependencies {
    implementation "androidx.annotation:annotation:1.9.1"
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation "androidx.annotation:annotation-experimental:1.5.1"
}

dependencies {
    implementation("androidx.annotation:annotation:1.9.1")
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation("androidx.annotation:annotation-experimental:1.5.1")
}

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nową kartę, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 1.9

Wersja 1.9.1

30 października 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.9.1 Wersja 1.9.1 zawiera te zmiany.

Poprawki błędów

• Dodano platformę docelową JS. (I2310b)
• Aktualizacja wersji Kotlina do 1.9 (I1a14c)

Wersja 1.9.0

16 października 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.9.0 Wersja 1.9.0 zawiera te zmiany.

Ważne zmiany od wersji 1.8.0

• Dodaliśmy obsługę tych platform Kotlin Multiplatform: watchosDeviceArm64, mingwX64, linuxArm64.

Wersja 1.9.0-rc01

2 października 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.9.0-rc01 Wersja 1.9.0-rc01 nie zawiera zmian w stosunku do poprzedniej wersji beta.

Wersja 1.9.0-beta01

18 września 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.9.0-beta01 Wersja 1.9.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

• Dodano obsługę platformy docelowej watchosDeviceArm64 (I1cc04, b/364652024).

Wersja 1.9.0-alpha03

4 września 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.9.0-alpha03 Wersja 1.9.0-alpha03 nie zawiera zmian w porównaniu z poprzednią wersją alfa.

Wersja 1.9.0-alpha02

21 sierpnia 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.9.0-alpha02 Wersja 1.9.0-alpha02 zawiera te zmiany.

Nowe funkcje

• Dodanie obsługi platformy mingwX64 (I461ca, b/349894318)
• Dodaliśmy obsługę platformy wieloplatformowej linuxArm64 w Kotlinie. (I139d3, b/338268719)

Wersja 1.9.0-alpha01

26 czerwca 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.9.0-alpha01 Wersja 1.9.0-alpha01 zawiera te zmiany.

Wkład zewnętrzny

• Dodaliśmy obsługę platformy docelowej linuxArm64 (dzięki Jake’owi Whartonowi!).

Wersja 1.8

Wersja 1.8.2

7 sierpnia 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.8.2 Wersja 1.8.2 zawiera te zmiany.

Poprawki błędów

• Dodanie obsługi platformy mingwX64 (I461ca, b/349894318)

Wersja 1.8.1

24 lipca 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.8.1 Wersja 1.8.1 zawiera te zmiany.

Poprawki błędów

• Zawiera dodatkowe platformy Kotlin Multiplatform: watchos, tvos.

Wersja 1.8.0

14 maja 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.8.0 Wersja 1.8.0 zawiera te zmiany.

Ważne zmiany od wersji 1.7.0

• Dodano adnotację @ReplaceWith, aby wskazywać zamienniki wycofanych interfejsów API.
• Adnotacja @MainThread została przeniesiona do wspólnego zbioru źródeł.

Wersja 1.8.0-rc01

1 maja 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.8.0-rc01 Wersja 1.8.0-rc01 nie zawiera zmian w porównaniu z poprzednią wersją beta.

Wersja 1.8.0-beta02

17 kwietnia 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.8.0-beta02 Wersja 1.8.0-beta02 nie zawiera zmian w porównaniu z poprzednią wersją.

Wersja 1.8.0-beta01

3 kwietnia 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.8.0-beta01 Wersja 1.8.0-beta01 zawiera te zmiany.

Nowe funkcje

• Adnotacja ReplaceWith jest już stabilna w interfejsie API, ale powiązane z nią sprawdzanie kodu z automatyczną poprawką nie zostało jeszcze udostępnione.

Wersja 1.8.0-alpha02

20 marca 2024 r.

Wersja androidx.annotation:annotation-*:1.8.0-alpha02 nie zawiera znaczących zmian. Wersja 1.8.0-alpha02 zawiera te zmiany.

Wersja 1.8.0-alpha01

21 lutego 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.8.0-alpha01 Wersja 1.8.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

• Dodano adnotację @ReplaceWith, aby wyrazić zamienniki wycofanych interfejsów API. (I38db3, b/322373864)

Wkład zewnętrzny

• Dziękujemy Ivanowi Matkovowi za przeniesienie adnotacji @MainThread do wspólnego zestawu źródeł. (6f228c)

Wersja 1.7

Wersja 1.7.1

13 grudnia 2023 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.7.1 Wersja 1.7.1 zawiera te zmiany.

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.

Zostanie wycofaneandroidx.annotation:annotation-*:1.7.0 Wersja 1.7.0 zawiera te zmiany.

Ważne zmiany od wersji 1.6.0

• Zawiera artefakty Kotlin Multiplatform przeznaczone na platformy iOS, Linux i macOS.
• Możesz teraz używać adnotacji w projektach KMM. Pamiętaj, że cele adnotacji inne niż Android są nadal w fazie eksperymentalnej, ale postanowiliśmy połączyć wersje, aby ułatwić deweloperom ich wypróbowanie. W trakcie prac nad wersją alfa niektóre adnotacje mogą być przenoszone między kodem wspólnym a kodem specyficznym dla platformy, ponieważ ustalamy ostateczne granice.

Wersja 1.7.0-rc01

23 sierpnia 2023 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.7.0-rc01 Wersja 1.7.0-rc01 zawiera te zmiany.

Ta wersja nie zawiera żadnych zmian w porównaniu z poprzednią wersją beta.

Wersja 1.7.0-beta01

9 sierpnia 2023 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.7.0-beta01 Wersja 1.7.0-beta01 zawiera te zmiany.

Nowe funkcje

• Stabilne interfejsy API do udostępnienia

Wersja 1.7.0-alpha03

26 lipca 2023 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.7.0-alpha03 Wersja 1.7.0-alpha03 zawiera te zmiany.

Poprawki błędów

• Publikacja Maven POM zawiera teraz domyślny artefakt wieloplatformowy przeznaczony dla JVM jako zależność

Wersja 1.7.0-alpha02

24 marca 2023 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.7.0-alpha02

Poprawki błędów

• Usunięto ograniczenia zależności z artefaktów Maven, aby obejść problem z kompilacją w przypadku natywnych elementów docelowych Kotlin (b/274786186, KT-57531).

Wersja 1.7.0-alpha01

22 marca 2023 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.7.0-alpha01 Wersja 1.7.0-alpha01 zawiera te zmiany.

Nowe funkcje

• Zawiera artefakty Kotlin Multiplatform przeznaczone na platformy iOS, Linux i macOS.
• Możesz teraz używać adnotacji w projektach KMM. Pamiętaj, że cele adnotacji inne niż Android są nadal w fazie eksperymentalnej, ale postanowiliśmy połączyć wersje, aby ułatwić deweloperom ich wypróbowanie. W trakcie prac nad wersją alfa niektóre adnotacje mogą być przenoszone między kodem wspólnym a kodem specyficznym dla platformy, ponieważ ustalamy ostateczne 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 opublikowane. Wersja 1.6.0 zawiera te zmiany.

Ważne zmiany od wersji 1.5.0

• Dodaje adnotację @RequiresExtension, aby wskazać, że interfejs API wymaga określonej wersji określonego pakietu SDK rozszerzenia (I5e4fe).
• Przekształcono bibliotekę adnotacji, aby można było ją tworzyć za pomocą łańcucha narzędzi Kotlin Multiplatform (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 opublikowane. Wersja 1.6.0-rc01 zawiera te zmiany.

• Adnotacje zostały ustabilizowane w wersji kandydującej do publikacji 1.6.0-rc01.

Wersja 1.6.0-beta01

25 stycznia 2023 r.

androidx.annotation:annotation:1.6.0-beta01 i androidx.annotation:annotation-jvm:1.6.0-beta01 są udostępniane bez zmian w stosunku do 1.6.0-alpha01.

Wersja 1.6.0-alpha01

11 stycznia 2023 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.6.0-alpha01 Wersja 1.6.0-alpha01 zawiera te zmiany.

Wersja 1.6.0-dev01

8 lutego 2023 r.

Zostanie wycofaneandroidx.annotation:annotation-*:1.6.0-dev01 Wersja 1.6.0-dev01 zawiera te zmiany.

• Adnotacja włączyła Kotlin Multiplatform w wersji 1.6.0-dev01 w ramach wersji deweloperskiej.

Nowe funkcje

• Dodaje adnotację @RequiresExtension, aby wskazać, że interfejs API wymaga określonej wersji określonego pakietu SDK rozszerzenia. (I5e4fe)
• Przekształcono bibliotekę adnotacji, aby można było ją tworzyć za pomocą łańcucha narzędzi Kotlin Multiplatform (I3be8d).

Wersja 1.5.0

Wersja 1.5.0

21 września 2022 r.

Zostanie wycofaneandroidx.annotation:annotation:1.5.0 Wersja 1.5.0 zawiera te zmiany.

Ważne zmiany od wersji 1.4.0

• Biblioteka adnotacji została w pełni przeniesiona do źródeł Kotlin, co zapewnia obsługę witryn docelowych specyficznych dla tego języka i innych funkcji adnotacji zgodnych z Kotlinem.

Wersja 1.5.0-rc01

7 września 2022 roku

Zostanie wycofaneandroidx.annotation:annotation:1.5.0-rc01 Wersja 1.5.0-rc01 zawiera te zmiany.

• Brak zmian w porównaniu z poprzednią wersją beta 1.5.0.

Wersja 1.5.0-beta01

24 sierpnia 2022 r.

Zostanie wycofaneandroidx.annotation:annotation:1.5.0-beta01 Wersja 1.5.0-beta01 zawiera te zmiany.

• Brak zmian w porównaniu z poprzednią wersją. Interfejs API został zamrożony na potrzeby wersji beta.

Wersja 1.5.0-alpha02

10 sierpnia 2022 r.

Zostanie wycofaneandroidx.annotation:annotation:1.5.0-alpha02 Wersja 1.5.0-alpha02 zawiera te zmiany.

• Brak zmian od poprzedniej wersji alfa.

Wersja 1.5.0-alpha01

27 lipca 2022 roku

Zostanie wycofaneandroidx.annotation:annotation:1.5.0-alpha01 Wersja 1.5.0-alpha01 zawiera te zmiany.

Nowe funkcje

• Biblioteka adnotacji została w pełni przeniesiona do źródeł Kotlin, co zapewnia obsługę witryn docelowych specyficznych dla tego języka i innych funkcji adnotacji zgodnych z Kotlinem.

Wersja 1.4.0

Wersja 1.4.0

15 czerwca 2022 r.

Zostanie wycofaneandroidx.annotation:annotation:1.4.0 Wersja 1.4.0 zawiera te zmiany.

Ważne zmiany od wersji 1.3.0

• @RestrictTo zostało przeniesione do źródeł Kotlin i obsługuje teraz witrynę @file. W rezultacie biblioteka adnotacji jest teraz zależna od standardowej biblioteki języka Kotlin.
• @ReturnThis (b/140249763): zapewnia, że metody zastępujące tę metodę muszą zwracać tę samą instancję (przeznaczoną dla konstruktorów itp.).
• @OpenForTesting (b/141539024): klasy i metody w języku Kotlin oznaczone jako „open” mogą być opatrzone tą adnotacją. Lint sprawdzi, czy ta klasa jest podklasą (a metody są zastępowane) tylko w testach jednostkowych.
• @DeprecatedSinceApi (b/37116481): wskazuje, że metoda (lub klasa lub pole) z adnotacją jest częścią biblioteki wstecznej dla interfejsu API platformy, która nie jest już potrzebna od danego poziomu interfejsu API.
• @EmptySuper: oznacza, że ta metoda jest zdefiniowana jako pusta, więc podczas zastępowania nie musisz jej wywoływać (a nawet nie powinieneś tego robić; może ona na przykład zawierać sprawdzanie zgodności wstecznej).

Wersja 1.4.0-rc01

1 czerwca 2022 r.

Zostanie wycofaneandroidx.annotation:annotation:1.4.0-rc01 Wersja 1.4.0-rc01 zawiera te zmiany.

• Interfejs API i jego funkcje zostały ukończone i są gotowe do udostępnienia.

Wersja 1.4.0-beta01

18 maja 2022 r.

Zostanie wycofaneandroidx.annotation:annotation:1.4.0-beta01 Wersja 1.4.0-beta01 zawiera te zmiany.

• Brak zmian od ostatniej wersji alfa. Powierzchnia interfejsu API została zablokowana na potrzeby wersji beta.

Wersja 1.4.0-alpha02

9 lutego 2022 r.

Zostanie wycofaneandroidx.annotation:annotation:1.4.0-alpha02 Wersja 1.4.0-alpha02 zawiera te zmiany.

Nowe funkcje

• Dodano adnotacje @ReturnThis, @OpenForTesting, @EmptySuper i @DeprecatedSinceApi. (21946a2)

• @ReturnThis (b/140249763): zapewnia, że metody zastępujące tę metodę muszą zwracać tę samą instancję (przeznaczoną dla konstruktorów itp.)

• @OpenForTesting (b/141539024): klasy i metody w języku Kotlin oznaczone jako „open” mogą być opatrzone tą adnotacją, a narzędzie lint będzie sprawdzać, czy ta klasa jest podklasą (a metody są zastępowane) tylko w testach jednostkowych.

• @DeprecatedSinceApi (b/37116481): wskazuje, że oznaczona adnotacją metoda (lub klasa lub pole) jest częścią biblioteki wstecznej dla interfejsu API platformy, która nie jest już potrzebna od danego poziomu interfejsu API.

• @EmptySuper: oznacza, że ta metoda jest zdefiniowana jako pusta, więc podczas zastępowania nie musisz jej wywoływać (a nawet nie powinieneś tego robić; może ona na przykład zawierać sprawdzanie zgodności wstecznej).

Wersja 1.4.0-alpha01

15 grudnia 2021 roku

Zostanie wycofaneandroidx.annotation:annotation:1.4.0-alpha01 Wersja 1.4.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

• Przeniesiono adnotację RestrictTo do źródeł Kotlin (Ia6336)

Wersja 1.3.0

Wersja 1.3.0

3 listopada 2021 r.

Zostanie wycofaneandroidx.annotation:annotation:1.3.0 Wersja 1.3.0 zawiera te zmiany.

Ważne zmiany od wersji 1.2.0

• @Discouraged do oznaczania interfejsów API, których nie można w rozsądny sposób wycofać, ale które mają znaczący negatywny wpływ na wydajność i nie powinny być wywoływane w normalnym kodzie produkcyjnym.
• @Context, aby oznaczać ogólne konteksty, dzięki czemu deweloperzy będą mogli łatwiej przejść na nowe interfejsy API.
• @GravityInt adnotacja do oznaczania elementów zawierających wartości grawitacji spakowane w liczby całkowite
• Wycofano @InspectableProperty na rzecz @Attribute w przypadku androidx.resourceinspection

Wersja 1.3.0-rc01

27 października 2021 roku

Zostanie wycofaneandroidx.annotation:annotation:1.3.0-rc01 Wersja 1.3.0-rc01 zawiera te zmiany.

Wersja 1.3.0-beta01

29 września 2021 r.

Zostanie wycofaneandroidx.annotation:annotation:1.3.0-beta01 Wersja 1.3.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

• Wymagaj wyjaśnienia w „wiadomości” w przypadku @Discouraged. (I3390f)
• Dodano adnotację @Discouraged do oznaczania elementów, których używanie jest odradzane. (Ib2549)
• Udostępnienie adnotacji RestrictTo w wyskakującym okienku dokumentów Studio (Ie8e1a, b/183134648)

Poprawki błędów

• Dodanie adnotacji Context, aby oznaczać ogólne konteksty, co ułatwi deweloperom przejście na nowe interfejsy API. (Ie581a)

Wersja 1.3.0-alpha01

24 marca 2021 r.

Zostanie wycofaneandroidx.annotation:annotation:1.3.0-alpha01 Wersja 1.3.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

• Wycofano @InspectableProperty na rzecz @Attribute w androidx.resourceinspection. (Ic0eff)
• Dodano adnotację @GravityInt do oznaczania elementów zawierających wartości siły grawitacji spakowane w liczby całkowite. (Ifcaa4, b/180620048)

Adnotacja – wersja eksperymentalna 1.5

Wersja 1.5.1

16 lipca 2025 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.5.1 Wersja 1.5.1 zawiera te zmiany.

Wersja 1.5.0

7 maja 2025 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.5.0 Wersja 1.5.0 zawiera te zmiany.

Ważne zmiany od wersji 1.4.0

• Dodano message do RequiresOptIn, aby dopasować adnotację biblioteki standardowej Kotlin z domyślną wartością pustego ciągu tekstowego. (I1f50e)
• Ta biblioteka jest teraz kierowana na poziom języka Kotlin 2.0 i wymaga KGP w wersji 2.0.0 lub nowszej. (Idb6b5)

Wersja 1.5.0-rc01

23 kwietnia 2025 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.5.0-rc01 Wersja 1.5.0-rc01 nie zawiera żadnych zmian w porównaniu z poprzednią wersją beta. Zobacz zatwierdzenia.

Wersja 1.5.0-beta01

9 kwietnia 2025 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.5.0-beta01 Wersja 1.5.0-beta01 zawiera te zmiany.

Ważne zmiany

• Ta biblioteka jest teraz kierowana na poziom języka Kotlin 2.0 i wymaga KGP w wersji 2.0.0 lub nowszej (Idb6b5).

Wersja 1.5.0-alpha01

21 sierpnia 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.5.0-alpha01 Wersja 1.5.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

• Dodaj message do RequiresOptIn, aby dopasować adnotację biblioteki standardowej języka Kotlin z domyślną wartością pustego ciągu. (I1f50e)

Adnotacja – wersja eksperymentalna 1.4

Wersja 1.4.1

3 kwietnia 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.4.1 Wersja 1.4.1 zawiera te zmiany.

Poprawki błędów

• Popraw użycie isKotlin, aby uniknąć przypadkowego wywołania sprawdzania RequiresOptIn w plikach Kotlin. (I2d8c1f)

Wersja 1.4.0

24 stycznia 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.4.0 Wersja 1.4.0 zawiera te zmiany.

Ważne zmiany od wersji 1.3.0

• Dodawanie obsługi Kotlin Multiplatform
• Rozwiązywanie problemów ze zgodnością z Kotlinem 2.0
• Wyświetlanie ostrzeżeń dotyczących użycia w kodzie Java właściwości Kotlina oznaczonych adnotacją eksperymentalną (I8bd43)
• Poprawianie umieszczania adnotacji automatycznej poprawki w metodach Kotlin (Id7a41)

Wersja 1.4.0-rc01

10 stycznia 2024 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.4.0-rc01 Wersja 1.4.0-rc01 nie zawiera zmian w porównaniu z poprzednią wersją.

Wersja 1.4.0-beta01

13 grudnia 2023 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.4.0-beta01 Brak zmian od poprzedniej wersji.

Wersja 1.4.0-alpha01

29 listopada 2023 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.4.0-alpha01 Wersja 1.4.0-alpha01 zawiera te zmiany.

Poprawki błędów

• Tymczasowo usuń sugestie automatycznych poprawek na poziomie klasy, aby obejść problem b/301598518. (Id98b2)
• Wyświetlanie ostrzeżeń dotyczących użycia w kodzie Java właściwości Kotlina oznaczonych adnotacją eksperymentalną (I8bd43)
• Poprawianie umieszczania adnotacji automatycznej poprawki w metodach Kotlin (Id7a41)

Wersja 1.4.0-dev01

8 lutego 2023 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.4.0-dev01 Wersja 1.4.0-dev01 zawiera te zmiany.

• W przypadku wersji 1.4.0-dev01 w ramach wersji testowej dla deweloperów włączyliśmy adnotacje eksperymentalne w Kotlinie na wiele platform.

Adnotacja – wersja eksperymentalna 1.3.1

Wersja 1.3.1

21 czerwca 2023 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.3.1 Wersja 1.3.1 zawiera te zmiany.

Poprawki błędów

• Umieszcza adnotację na początku listy modyfikatorów podczas stosowania automatycznej poprawki. (b/251172715)
• Używanie sprawdzania kodu, aby zniechęcać do używania androidx.annotation.RequiresOptIn w kodzie źródłowym Kotlinu (b/241097743)

Adnotacje – wersja eksperymentalna 1.3.0

Wersja 1.3.0

7 września 2022 roku

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.3.0 Wersja 1.3.0 zawiera te zmiany.

Ważne zmiany od wersji 1.2.0

• Dodaliśmy obsługę używania @androidx.annotation.OptIn na poziomie pakietu (I24d58)
• Przeniesiono zależność biblioteki standardowej języka Kotlin do typu API zamiast tylko do kompilacji. Oznacza to, że wszyscy klienci biblioteki Annotation-Experimental będą uwzględniać bibliotekę standardową Kotlin w swoich zależnościach przechodnich.

Wersja 1.3.0-rc01

24 sierpnia 2022 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.3.0-rc01 Wersja 1.3.0-rc01 zawiera te zmiany.

• Brak zmian w porównaniu z poprzednią wersją. Implementacja została zablokowana w przypadku RC.

Wersja 1.3.0-beta01

10 sierpnia 2022 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.3.0-beta01 Wersja 1.3.0-beta01 zawiera te zmiany.

• Brak zmian w porównaniu z wersją alfa. Ta biblioteka została ustabilizowana na potrzeby wersji beta.

Wersja 1.3.0-alpha01

27 lipca 2022 roku

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.3.0-alpha01 Wersja 1.3.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

• Dodaliśmy obsługę używania @androidx.annotation.OptIn na poziomie pakietu (I24d58)

Annotation-Experimental Version 1.2.0

Wersja 1.2.0

15 grudnia 2021 roku

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.2.0 Wersja 1.2.0 zawiera te zmiany.

Ważne zmiany od wersji 1.1.0

Ta biblioteka jest teraz kierowana na poziom języka Java 8.

Wersja 1.2.0-rc01

1 grudnia 2021 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.2.0-rc01 Wersja 1.2.0-rc01 zawiera te zmiany.

Brak zmian w stosunku do wersji beta.

Wersja 1.2.0-beta01

17 listopada 2021 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.2.0-beta01 Wersja 1.2.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

Interfejsy API zostały ukończone i są dostępne w wersji beta.

Annotation-Experimental Version 1.2.0-alpha01

30 czerwca 2021 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.2.0-alpha01 Wersja 1.2.0-alpha01 zawiera te zmiany.

Nowe funkcje

• Biblioteka jest teraz kierowana na poziom języka Java 8

Wersja 1.2.0

Wersja 1.2.0

24 marca 2021 r.

Zostanie wycofaneandroidx.annotation:annotation:1.2.0 Wersja 1.2.0 zawiera te zmiany.

Główne zmiany od wersji 1.1.0

• Dodano adnotację @ChecksSdkIntAtLeast, której można używać do identyfikowania metod lub pól używanych do ograniczania dostępu na poziomie pakietu SDK i spełniania wymagań kontroli NewApi.
• Dodaliśmy adnotację @DoNotInline, która jest powiązana z regułą Proguard, aby zapobiec wstawianiu elementów w kodzie podczas optymalizacji.
• Różne adnotacje są teraz oznaczone symbolem @Documented, aby były widoczne w dokumentacji dotyczącej oznaczonych elementów.

Wersja 1.2.0-rc01

24 lutego 2021 r.

Zostanie wycofaneandroidx.annotation:annotation:1.2.0-rc01 Wersja 1.2.0-rc01 zawiera te zmiany.

Wersja 1.2.0-beta01

13 stycznia 2021 r.

Zostanie wycofaneandroidx.annotation:annotation:1.2.0-beta01 Wersja 1.2.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

• Nowa adnotacja @DoNotInline, która nakazuje optymalizatorom kodu (np. Proguard, R8) nie wstawiać metody z adnotacją. (I3dfe8, b/141326133)

Wersja 1.2.0-alpha01

14 maja 2020 r.

Zostanie wycofaneandroidx.annotation:annotation:1.2.0-alpha01 Wersja 1.2.0-alpha01 zawiera te zmiany.

Nowe funkcje

• Dodano adnotację @ChecksSdkIntAtLeast. Umożliwia to bibliotece androidx i użytkownikom dodawanie adnotacji do metod i pól, które reprezentują sprawdzanie SDK_INT. (I89a54, b/120255046)

Annotation-Experimental Version 1.1.0

Wersja 1.1.0

7 kwietnia 2021 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.1.0 Wersja 1.1.0 zawiera te zmiany.

Główne zmiany od wersji 1.0.0

• Eksperymentalne adnotacje Jetpack zostały przepisane w języku Kotlin, aby obsługiwać wiele klas znaczników i lepiej radzić sobie z wycofywaniem funkcji.
• Dodano adnotacje RequiresOptIn i OptIn, aby zapewnić zgodność z Kotlinem, a adnotacje Experimental i UsesExperimental zostały wycofane.

Wersja 1.1.0-rc02

24 marca 2021 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.1.0-rc02 Wersja 1.1.0-rc02 zawiera te zmiany.

Poprawki błędów

• Dodano reguły Proguard, aby optymalizacja kodu nie ostrzegała o brakujących meta-adnotacjach Kotlin.

Wersja 1.1.0-rc01

10 marca 2021 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.1.0-rc01 Wersja 1.1.0-rc01 zawiera te zmiany.

Brak zmian od poprzedniej wersji beta.

Wersja 1.1.0-beta01

27 stycznia 2021 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.1.0-beta01 Wersja 1.1.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

• Wariant androidx adnotacji Experimental został wycofany, aby zapewnić zgodność z Kotlinem. Została ona zastąpiona wariantem androidx adnotacji RequiresOptIn, a linter Java został zaktualizowany, aby obsługiwać zarówno nową adnotację Kotlin, jak i nowy wariant androidx. (I52495, b/151331381)

Wersja 1.1.0-alpha01

22 lipca 2020 r.

Zostanie wycofaneandroidx.annotation:annotation-experimental:1.1.0-alpha01 Wersja 1.1.0-alpha01 zawiera te zmiany.

Nowe funkcje

• Biblioteka adnotacji eksperymentalnych jest teraz napisana w języku Kotlin, ale nie wymaga dołączenia biblioteki standardowej Kotlin jako zależności. Zawiera plik Proguard, który umożliwia usuwanie zbędnych metadanych Kotlin z projektów, w których używany jest tylko język programowania Java.
• @UseExperimental obsługuje teraz wiele klas znaczników (aosp/1185577, b/145137892).

Annotation-Experimental Version 1.0.0

Annotation-Experimental Version 1.0.0

7 listopada 2019 r.

androidx.annotation:annotation-experimental:1.0.0 i androidx.annotation:annotation-experimental-lint:1.0.0 zostały wydane bez zmian od 1.0.0-rc01. Wersja 1.0.0 zawiera te zmiany.

Główne funkcje wersji 1.0.0

• Wymuszanie semantyki Kotlin @Experimental w kodzie źródłowym Java na podstawie narzędzia Lint
• Adnotacje Java, które zapewniają działanie podobne do adnotacji @Experimental i @UseExperimental w Kotlinie bez konieczności zależności od Kotlina.

Annotation-Experimental Version 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 opublikowane. Wersja 1.0.0-rc01 zawiera te commity.

Znane problemy

W stabilnej wersji Studio 3.5 ostrzeżenia z detektora lint @Experimental nie są wyświetlane w IDE w przypadku nieprawidłowego użycia w kodzie Java adnotacji @Experimental w języku Kotlin. Zobacz b/140640322.

Annotation-Experimental w wersji 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 wydane bez zmian w stosunku do wersji 1.0.0-alpha01. Wersja 1.0.0-beta01 zawiera te zmiany.

Annotation-Experimental Version 1.0.0-alpha01

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 opublikowane. Są to zatwierdzenia uwzględnione w annotation-experimental 1.0.0-alpha01 i zatwierdzenia uwzględnione w annotation-experimental-lint 1.0.0-alpha01.

Nowe funkcje

• Biblioteka adnotacji Jetpack Experimental udostępnia implementację znaczników eksperymentalnych interfejsów API w języku Kotlin, która jest zgodna z językiem Java. Artefakt -lint udostępnia implementację eksperymentalnych ograniczeń użytkowania opartą na Lint i wymusza ograniczenia dotyczące użycia w kodzie Java natywnych eksperymentalnych znaczników interfejsu API Kotlin.

• Jeśli używasz artefaktu annotation-experimental jako zależności, reguły Lint dostarczone przez artefakt annotation-experimental-lint będą automatycznie egzekwowane.

Wersja 1.1.0

Wersja 1.1.0

5 czerwca 2019 r.

androidx.annotation:annotation:1.1.0 została wydana bez zmian w stosunku do wersji 1.1.0-rc01.

Wersja 1.1.0-rc01

7 maja 2019 r.

androidx.annotation:annotation:1.1.0-rc01 zostaje opublikowany bez zmian w stosunku do 1.1.0-beta01. Listę zmian w tej wersji znajdziesz tutaj.

Wersja 1.1.0-beta01

3 kwietnia 2019 r.

Zostanie wycofaneandroidx.annotation:annotation:1.1.0-beta01 Listę zmian w tej wersji znajdziesz tutaj.

Nowe funkcje

• Nowa adnotacja @InspectableProperty obsługująca nowe interfejsy API sprawdzania widoku dodane w Androidzie 10. Tę adnotację można stosować do metod pobierających w widokach lub innych elementach interfejsu. Narzędzia do generowania kodu mogą go używać 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 obciążenia związanego z odbiciem.

Zmiany w interfejsie API

• Zmiana powodująca niezgodność: @ContentView zostało zmienione 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 tej adnotacji w modułach biblioteki. (b/128352521)

Wersja 1.1.0-alpha02

13 marca 2019 r.

Zostanie wycofaneandroidx.annotation:annotation:1.1.0-alpha02 Pełną listę zmian w tej wersji znajdziesz tutaj.

Nowe funkcje

• Nowy zakres ograniczeń interfejsu API: RestrictTo.Scope.LIBRARY_GROUP_PREFIX. Ogranicza użycie do kodu w pakietach, których grupy mają ten sam prefiks grupy biblioteki aż do ostatniej kropki (.). Na przykład biblioteki foo.bar:lib1 i foo.baz:lib2 mają wspólny prefiks foo, więc mogą korzystać z interfejsów API drugiej biblioteki, które są ograniczone do tego zakresu. Podobnie w przypadku com.foo.bar:lib1 i com.foo.baz:lib2 mają one wspólny prefiks com.foo. i mogą udostępniać interfejsy API ograniczone do tego zakresu. Biblioteka com.bar.qux:lib3 nie będzie jednak mogła korzystać z interfejsu API z ograniczeniami, ponieważ udostępnia tylko prefiks com., a nie wszystkie znaki aż do ostatniego znaku . (kropki).

Wersja 1.1.0-alpha01

30 stycznia 2019 r.

Zostanie wycofaneandroidx.annotation:annotation 1.1.0-alpha01

Nowe funkcje

• Dodano adnotację @ContentView, która pozwala wskazać, który plik XML układu ma zostać rozszerzony. Jest to obsługiwane w ComponentActivity w wersji 1.0.0-alpha04 i w Fragment w wersji 1.1.0-alpha04 jako alternatywa dla używania odpowiednio setContentView() lub zastępowania onCreateView(). (aosp/837619)

Wersja 1.0.2

Wersja 1.0.2

25 lutego 2019 r.

Zostanie wycofaneandroidx.annotation:annotation 1.0.2

Poprawki błędów

• Popraw reguły R8/ProGuard osadzone w pliku JAR. Nieprawidłowo odwoływały się one do starych typów android.support.annotation zamiast do androidx.annotation. Uwaga: miałoby to wpływ na Twoje kompilacje tylko wtedy, gdyby nie używano getDefaultProguardFile, ponieważ te domyślne reguły zawierały też prawidłowe reguły dla obu pakietów. (aosp/891685)
• Dodaj regułę R8/ProGuard, która jawnie zachowuje samą adnotację @Keep. Dzięki temu ProGuard nie usunie adnotacji z typów, zanim nie zastosuje jej semantyki. Uwaga: miałoby to wpływ na Twoje kompilacje tylko wtedy, gdyby nie używano getDefaultProguardFile, ponieważ te domyślne reguły zawierały też prawidłowe reguły dla obu pakietów. (aosp/903818)