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 nowy problem, 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.

Publikacja androidx.annotation:annotation-*:1.9.1 Wersja 1.9.1 zawiera te zatwierdzenia.

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.

Publikacja androidx.annotation:annotation-*:1.9.0 Wersja 1.9.0 zawiera te zatwierdzenia.

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.

Publikacja androidx.annotation:annotation-*:1.9.0-rc01 Wersja 1.9.0-rc01 nie zawiera zmian w porównaniu z poprzednią wersją beta.

Wersja 1.9.0-beta01

18 września 2024 r.

Publikacja androidx.annotation:annotation-*:1.9.0-beta01 Wersja 1.9.0-beta01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

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

Wersja 1.9.0-alpha03

4 września 2024 r.

Publikacja androidx.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.

Publikacja androidx.annotation:annotation-*:1.9.0-alpha02 Wersja 1.9.0-alpha02 zawiera te zatwierdzenia.

Nowe funkcje

• Dodanie obsługi platformy mingwX64 (I461ca, b/349894318)
• Dodano obsługę platformy linuxArm64 Kotlin Multiplatform. (I139d3, b/338268719)

Wersja 1.9.0-alpha01

26 czerwca 2024 r.

Publikacja androidx.annotation:annotation-*:1.9.0-alpha01 Wersja 1.9.0-alpha01 zawiera te zatwierdzenia.

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.

Publikacja androidx.annotation:annotation-*:1.8.2 Wersja 1.8.2 zawiera te zatwierdzenia.

Poprawki błędów

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

Wersja 1.8.1

24 lipca 2024 r.

Publikacja androidx.annotation:annotation-*:1.8.1 Wersja 1.8.1 zawiera te zmiany.

Poprawki błędów

• Obejmuje dodatkowe platformy Kotlin Multiplatform: watchos, tvos.

Wersja 1.8.0

14 maja 2024 r.

Publikacja androidx.annotation:annotation-*:1.8.0 Wersja 1.8.0 zawiera te zatwierdzenia.

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.

Publikacja androidx.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.

Publikacja androidx.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.

Publikacja androidx.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 za pomocą narzędzia lint 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.

Publikacja androidx.annotation:annotation-*:1.8.0-alpha01 Wersja 1.8.0-alpha01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodano adnotację @ReplaceWith, aby wskazać 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.

Publikacja androidx.annotation:annotation-*:1.7.1 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.

Publikacja androidx.annotation:annotation-*:1.7.0 Wersja 1.7.0 zawiera te zatwierdzenia.

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 ogólnym a kodem specyficznym dla platformy, ponieważ ustalamy ostateczne granice.

Wersja 1.7.0-rc01

23 sierpnia 2023 r.

Publikacja androidx.annotation:annotation-*:1.7.0-rc01 Wersja 1.7.0-rc01 zawiera te zatwierdzenia.

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

Wersja 1.7.0-beta01

9 sierpnia 2023 r.

Publikacja androidx.annotation:annotation-*:1.7.0-beta01 Wersja 1.7.0-beta01 zawiera te zatwierdzenia.

Nowe funkcje

• Stabilne interfejsy API do udostępnienia

Wersja 1.7.0-alpha03

26 lipca 2023 r.

Publikacja androidx.annotation:annotation-*:1.7.0-alpha03 Wersja 1.7.0-alpha03 zawiera te zatwierdzenia.

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.

Publikacja androidx.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 platform Kotlin Native (b/274786186, KT-57531).

Wersja 1.7.0-alpha01

22 marca 2023 r.

Publikacja androidx.annotation:annotation-*:1.7.0-alpha01 Wersja 1.7.0-alpha01 zawiera te zatwierdzenia.

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 ogólnym a kodem specyficznym dla platformy, ponieważ ustalamy ostateczne granice.

Wersja 1.6

Wersja 1.6.0

22 lutego 2023 roku

Publikacje 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, 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.

Publikacje 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 została ustabilizowana w wersji kandydującej 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.

Publikacja androidx.annotation:annotation-*:1.6.0-alpha01 Wersja 1.6.0-alpha01 zawiera te zatwierdzenia.

Wersja 1.6.0-dev01

8 lutego 2023 r.

Publikacja androidx.annotation:annotation-*:1.6.0-dev01 Wersja 1.6.0-dev01 zawiera te zatwierdzenia.

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

Publikacja androidx.annotation:annotation:1.5.0 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 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

Publikacja androidx.annotation:annotation:1.5.0-rc01 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.

Publikacja androidx.annotation:annotation:1.5.0-beta01 Wersja 1.5.0-beta01 zawiera te zatwierdzenia.

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

Publikacja androidx.annotation:annotation:1.5.0-alpha02 Wersja 1.5.0-alpha02 zawiera te zatwierdzenia.

• Brak zmian od poprzedniej wersji alfa.

Wersja 1.5.0-alpha01

27 lipca 2022 roku

Publikacja androidx.annotation:annotation:1.5.0-alpha01 Wersja 1.5.0-alpha01 zawiera te zatwierdzenia.

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.

Publikacja androidx.annotation:annotation:1.4.0 Wersja 1.4.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.3.0

• @RestrictTo zostało przeniesione do źródeł Kotlin i obsługuje teraz witrynę @file. W związku z tym 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 zadba o to, aby ta klasa była podklasą (a metody były 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.

Publikacja androidx.annotation:annotation:1.4.0-rc01 Wersja 1.4.0-rc01 zawiera te zatwierdzenia.

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

Wersja 1.4.0-beta01

18 maja 2022 r.

Publikacja androidx.annotation:annotation:1.4.0-beta01 Wersja 1.4.0-beta01 zawiera te zatwierdzenia.

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

Publikacja androidx.annotation:annotation:1.4.0-alpha02 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ę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

Publikacja androidx.annotation:annotation:1.4.0-alpha01 Wersja 1.4.0-alpha01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

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

Wersja 1.3.0

Wersja 1.3.0

3 listopada 2021 r.

Publikacja androidx.annotation:annotation:1.3.0 Wersja 1.3.0 zawiera te zatwierdzenia.

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

Publikacja androidx.annotation:annotation:1.3.0-rc01 Wersja 1.3.0-rc01 zawiera te zatwierdzenia.

Wersja 1.3.0-beta01

29 września 2021 r.

Publikacja androidx.annotation:annotation:1.3.0-beta01 Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

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.

Publikacja androidx.annotation:annotation:1.3.0-alpha01 Wersja 1.3.0-alpha01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

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

Annotation-Experimental w wersji 1.6

Wersja 1.6.0-alpha01

22 października 2025 r.

Publikacja androidx.annotation:annotation-experimental:1.6.0-alpha01 Wersja 1.6.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

• Adnotacja OptIn obsługuje teraz ElementType.PARAMETER target.

Annotation-Experimental w wersji 1.5

Wersja 1.5.1

16 lipca 2025 r.

Publikacja androidx.annotation:annotation-experimental:1.5.1 Wersja 1.5.1 zawiera te zmiany.

Wersja 1.5.0

7 maja 2025 r.

Publikacja androidx.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.

Publikacja androidx.annotation:annotation-experimental:1.5.0-rc01 Wersja 1.5.0-rc01 nie zawiera zmian w porównaniu z poprzednią wersją beta. Zobacz zatwierdzenia.

Wersja 1.5.0-beta01

9 kwietnia 2025 r.

Publikacja androidx.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.

Publikacja androidx.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 Kotlin z domyślną wartością pustego ciągu. (I1f50e)

Annotation-Experimental w wersji 1.4

Wersja 1.4.1

3 kwietnia 2024 r.

Publikacja androidx.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.

Publikacja androidx.annotation:annotation-experimental:1.4.0 Wersja 1.4.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.3.0

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

Wersja 1.4.0-rc01

10 stycznia 2024 r.

Publikacja androidx.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.

Publikacja androidx.annotation:annotation-experimental:1.4.0-beta01 Brak zmian od poprzedniej wersji.

Wersja 1.4.0-alpha01

29 listopada 2023 r.

Publikacja androidx.annotation:annotation-experimental:1.4.0-alpha01 Wersja 1.4.0-alpha01 zawiera te zatwierdzenia.

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 Kotlin oznaczonych adnotacją eksperymentalną (I8bd43)
• Poprawianie umieszczania adnotacji automatycznej poprawki w metodach Kotlin (Id7a41)

Wersja 1.4.0-dev01

8 lutego 2023 r.

Publikacja androidx.annotation:annotation-experimental:1.4.0-dev01 Wersja 1.4.0-dev01 zawiera te zatwierdzenia.

• W przypadku wersji deweloperskiej 1.4.0-dev01 wtyczka annotation-experimental włączyła Kotlin Multiplatform.

Annotation-Experimental w wersji 1.3.1

Wersja 1.3.1

21 czerwca 2023 r.

Publikacja androidx.annotation:annotation-experimental:1.3.1 Wersja 1.3.1 zawiera te zatwierdzenia.

Poprawki błędów

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

Annotation-Experimental w wersji 1.3.0

Wersja 1.3.0

7 września 2022 roku

Publikacja androidx.annotation:annotation-experimental:1.3.0 Wersja 1.3.0 zawiera te zatwierdzenia.

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 Kotlin do typu API zamiast tylko do kompilacji. Oznacza to, że wszyscy klienci biblioteki Annotation-Experimental będą mieli w swoich zależnościach przechodnich standardową bibliotekę Kotlin.

Wersja 1.3.0-rc01

24 sierpnia 2022 r.

Publikacja androidx.annotation:annotation-experimental:1.3.0-rc01 Wersja 1.3.0-rc01 zawiera te zatwierdzenia.

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

Wersja 1.3.0-beta01

10 sierpnia 2022 r.

Publikacja androidx.annotation:annotation-experimental:1.3.0-beta01 Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

• 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

Publikacja androidx.annotation:annotation-experimental:1.3.0-alpha01 Wersja 1.3.0-alpha01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

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

Annotation-Experimental w wersji 1.2.0

Wersja 1.2.0

15 grudnia 2021 roku

Publikacja androidx.annotation:annotation-experimental:1.2.0 Wersja 1.2.0 zawiera te zatwierdzenia.

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.

Publikacja androidx.annotation:annotation-experimental:1.2.0-rc01 Wersja 1.2.0-rc01 zawiera te zatwierdzenia.

Brak zmian w stosunku do wersji beta.

Wersja 1.2.0-beta01

17 listopada 2021 r.

Publikacja androidx.annotation:annotation-experimental:1.2.0-beta01 Wersja 1.2.0-beta01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

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

Annotation-Experimental w wersji 1.2.0-alpha01

30 czerwca 2021 r.

Publikacja androidx.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.

Publikacja androidx.annotation:annotation:1.2.0 Wersja 1.2.0 zawiera te zatwierdzenia.

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.

Publikacja androidx.annotation:annotation:1.2.0-rc01 Wersja 1.2.0-rc01 zawiera te zatwierdzenia.

Wersja 1.2.0-beta01

13 stycznia 2021 r.

Publikacja androidx.annotation:annotation:1.2.0-beta01 Wersja 1.2.0-beta01 zawiera te zatwierdzenia.

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.

Publikacja androidx.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 w wersji 1.1.0

Wersja 1.1.0

7 kwietnia 2021 r.

Publikacja androidx.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.

Publikacja androidx.annotation:annotation-experimental:1.1.0-rc02 Wersja 1.1.0-rc02 zawiera te zatwierdzenia.

Poprawki błędów

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

Wersja 1.1.0-rc01

10 marca 2021 r.

Publikacja androidx.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.

Publikacja androidx.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.

Publikacja androidx.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, które używają tylko języka programowania Java.
• @UseExperimental obsługuje teraz wiele klas znaczników (aosp/1185577, b/145137892).

Annotation-Experimental w wersji 1.0.0

Annotation-Experimental w wersji 1.0.0

7 listopada 2019 r.

androidx.annotation:annotation-experimental:1.0.0 i androidx.annotation:annotation-experimental-lint:1.0.0 są udostępniane bez zmian od 1.0.0-rc01. Wersja 1.0.0 zawiera te zatwierdzenia.

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ą zachowanie równoważne adnotacjom @Experimental i @UseExperimental w Kotlinie bez konieczności zależności od Kotlina.

Annotation-Experimental w wersji 1.0.0-rc01

23 października 2019 r.

Publikacje 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

W stabilnej wersji Studio 3.5 ostrzeżenia z detektora lint @Experimental usage nie są wyświetlane w IDE w przypadku nieprawidłowego użycia w kodzie Java adnotacji Kotlin @Experimental. 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 zatwierdzenia.

Annotation-Experimental w wersji 1.0.0-alpha01

18 września 2019 r.

Publikacje androidx.annotation:annotation-experimental:1.0.0-alpha01 i androidx.annotation:annotation-experimental-lint:1.0.0-alpha01 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ą egzekwowane automatycznie.

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. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Wersja 1.1.0-beta01

3 kwietnia 2019 r.

Publikacja androidx.annotation:annotation:1.1.0-beta01 Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Nowe funkcje

• Nowa adnotacja @InspectableProperty obsługująca nowe interfejsy API do sprawdzania widoków dodane w Androidzie 10. Tę adnotację można stosować do getterów 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.

Publikacja androidx.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 bibliotek 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ą korzystać z interfejsów API ograniczonych 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.

Publikacja androidx.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.

Publikacja androidx.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)