Adnotacja

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

Deklarowanie zależności

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

Dodaj zależności dla artefaktów, których potrzebujesz, 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.4.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.4.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 zauważysz 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 zagłosować na istniejący problem, klikając przycisk z gwiazdką.

Tworzenie nowego zgłoszenia

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

Wersja 1.9

Wersja 1.9.1

30 października 2024 r.

androidx.annotation:annotation-*:1.9.1 został zwolniony. Wersja 1.9.1 zawiera te komity.

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.

androidx.annotation:annotation-*:1.9.0 został zwolniony. Wersja 1.9.0 zawiera te komisy.

Ważne zmiany od wersji 1.8.0

• Dodano obsługę tych wersji docelowych Kotlin Multiplatform: watchosDeviceArm64, mingwX64, linuxArm64.

Wersja 1.9.0-rc01

2 października 2024 r.

androidx.annotation:annotation-*:1.9.0-rc01 został zwolniony. Wersja 1.9.0-rc01 nie zawiera żadnych zmian w stosunku do poprzedniej wersji beta.

Wersja 1.9.0-beta01

18 września 2024 r.

androidx.annotation:annotation-*:1.9.0-beta01 został zwolniony. Wersja 1.9.0-beta01 zawiera te komity.

Zmiany w interfejsie API

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

Wersja 1.9.0-alpha03

4 września 2024 r.

androidx.annotation:annotation-*:1.9.0-alpha03 został zwolniony. Wersja 1.9.0-alpha03 nie zawiera żadnych zmian w stosunku do poprzedniej wersji alpha.

Wersja 1.9.0-alpha02

21 sierpnia 2024 r.

androidx.annotation:annotation-*:1.9.0-alpha02 został zwolniony. Wersja 1.9.0-alpha02 zawiera te komity.

Nowe funkcje

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

Wersja 1.9.0-alpha01

26 czerwca 2024 r.

androidx.annotation:annotation-*:1.9.0-alpha01 został zwolniony. Wersja 1.9.0-alpha01 zawiera te zatwierdzenia.

Darowizna zewnętrzna

• Dodano obsługę wieloplatformowego celu linuxArm64 (dzięki Jake’owi Whartonowi)

Wersja 1.8

Wersja 1.8.2

7 sierpnia 2024 r.

androidx.annotation:annotation-*:1.8.2 został zwolniony. Wersja 1.8.2 zawiera te komity.

Poprawki błędów

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

Wersja 1.8.1

24 lipca 2024 r.

androidx.annotation:annotation-*:1.8.1 został zwolniony. Wersja 1.8.1 zawiera te komity.

Poprawki błędów

• Obejmuje dodatkowe platformy docelowe Kotlin Multiplatform: watchos i tvos.

Wersja 1.8.0

14 maja 2024 r.

androidx.annotation:annotation-*:1.8.0 został zwolniony. Wersja 1.8.0 zawiera te komisy.

Ważne zmiany od wersji 1.7.0

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

Wersja 1.8.0-rc01

1 maja 2024 r.

androidx.annotation:annotation-*:1.8.0-rc01 został zwolniony. Wersja 1.8.0-rc01 nie zawiera żadnych zmian w porównaniu z poprzednią wersją beta.

Wersja 1.8.0-beta02

17 kwietnia 2024 r.

androidx.annotation:annotation-*:1.8.0-beta02 został zwolniony. Wersja 1.8.0-beta02 nie zawiera żadnych zmian w stosunku do poprzedniej wersji.

Wersja 1.8.0-beta01

3 kwietnia 2024 r.

androidx.annotation:annotation-*:1.8.0-beta01 został zwolniony. Wersja 1.8.0-beta01 zawiera te komity.

Nowe funkcje

• Adnotacja ReplaceWith jest teraz stabilna pod względem interfejsu API, ale powiązany z nią test lint z automatyczną poprawką nie został jeszcze udostępniony

Wersja 1.8.0-alpha02

20 marca 2024 r.

androidx.annotation:annotation-*:1.8.0-alpha02 jest publikowana bez istotnych zmian. Wersja 1.8.0-alpha02 zawiera te komity.

Wersja 1.8.0-alpha01

21 lutego 2024 r.

androidx.annotation:annotation-*:1.8.0-alpha01 został zwolniony. Wersja 1.8.0-alpha01 zawiera te commity.

Zmiany w interfejsie API

• Dodano adnotację @ReplaceWith, aby umożliwić zastąpienie wycofanych interfejsów API. (I38db3, b/322373864)

Wkład zewnętrzny

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

Wersja 1.7

Wersja 1.7.1

13 grudnia 2023 r.

androidx.annotation:annotation-*:1.7.1 został zwolniony. Wersja 1.7.1 zawiera te zatwierdzenia.

Poprawki błędów

• Podczas wstawiania domyślnej zależności od platformy użyj zakresu compile. (I4958f)

Wersja 1.7.0

6 września 2023 r.

androidx.annotation:annotation-*:1.7.0 został zwolniony. Wersja 1.7.0 zawiera te commity.

Ważne zmiany od wersji 1.6.0

• Obejmuje artefakty Kotlin Multiplatform przeznaczone na platformy iOS, Linux i macOS.
• Adnotacje możesz teraz używać w projektach KMM. Zaznaczamy, że adnotacje na platformach innych niż Android są nadal w wersji eksperymentalnej, ale postanowiliśmy połączyć wersje, aby ułatwić deweloperom ich wypróbowanie. W trakcie rozwoju wersji alfa, gdy będziemy określać granice, niektóre adnotacje mogą się przemieszczać między kodem wspólnym a specyficznym dla danej platformy.

Wersja 1.7.0-rc01

23 sierpnia 2023 r.

androidx.annotation:annotation-*:1.7.0-rc01 został zwolniony. 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.

androidx.annotation:annotation-*:1.7.0-beta01 został zwolniony. Wersja 1.7.0-beta01 zawiera te commity.

Nowe funkcje

• Stabilne interfejsy API do wydania

Wersja 1.7.0-alpha03

26 lipca 2023 r.

androidx.annotation:annotation-*:1.7.0-alpha03 został zwolniony. Wersja 1.7.0-alpha03 zawiera te commity.

Poprawki błędów

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

Wersja 1.7.0-alpha02

24 marca 2023 r.

androidx.annotation:annotation-*:1.7.0-alpha02 został zwolniony.

Poprawki błędów

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

Wersja 1.7.0-alpha01

22 marca 2023 r.

androidx.annotation:annotation-*:1.7.0-alpha01 został zwolniony. Wersja 1.7.0-alpha01 zawiera te commity.

Nowe funkcje

• Obejmuje artefakty Kotlin Multiplatform przeznaczone na platformy iOS, Linux i macOS.
• Adnotacje możesz teraz używać w projektach KMM. Zaznaczamy, że adnotacje na platformach innych niż Android są nadal w wersji eksperymentalnej, ale postanowiliśmy połączyć wersje, aby ułatwić deweloperom ich wypróbowanie. W trakcie rozwoju wersji alfa, gdy będziemy określać granice, niektóre adnotacje mogą się przemieszczać między kodem wspólnym a specyficznym dla danej platformy.

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 są dostępne. 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 konkretnego pakietu SDK rozszerzenia (I5e4fe).
• Konwertowana biblioteka adnotacji do kompilacji za pomocą 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 są dostępne. Wersja 1.6.0-rc01 zawiera te zatwierdzenia.

• Adnotacje zostały ustabilizowane w wersji 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ą publikowane bez zmian w porównaniu z wersją 1.6.0-alpha01.

Wersja 1.6.0-alpha01

11 stycznia 2023 r.

androidx.annotation:annotation-*:1.6.0-alpha01 został zwolniony. Wersja 1.6.0-alpha01 zawiera te commity.

Wersja 1.6.0-dev01

8 lutego 2023 r.

androidx.annotation:annotation-*:1.6.0-dev01 został zwolniony. Wersja 1.6.0-dev01 zawiera te commity.

• W annotacji włączono Kotlin multiplatform na potrzeby wersji 1.6.0-dev01 dla deweloperów.

Nowe funkcje

• Dodaje adnotację @RequiresExtension, aby wskazać, że interfejs API wymaga określonej wersji konkretnego pakietu SDK rozszerzenia. (I5e4fe)
• Konwertowana biblioteka adnotacji do kompilacji za pomocą narzędzi Kotlin Multiplatform (I3be8d)

Wersja 1.5.0

Wersja 1.5.0

21 września 2022 r.

androidx.annotation:annotation:1.5.0 został zwolniony. Wersja 1.5.0 zawiera te commity.

Ważne zmiany od wersji 1.4.0

• Biblioteka adnotacji została w pełni przeniesiona do źródeł Kotlina, co umożliwiło obsługę witryn docelowych na potrzeby Kotlina i innych funkcji adnotacji zgodnych z Kotlinem.

Wersja 1.5.0-rc01

7 września 2022 roku

androidx.annotation:annotation:1.5.0-rc01 został zwolniony. 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.

androidx.annotation:annotation:1.5.0-beta01 został zwolniony. Wersja 1.5.0-beta01 zawiera te commity.

• Brak zmian w stosunku do poprzedniej wersji. Interfejs API został zamrożony w wersji beta.

Wersja 1.5.0-alpha02

10 sierpnia 2022 r.

androidx.annotation:annotation:1.5.0-alpha02 został zwolniony. Wersja 1.5.0-alpha02 zawiera te commity.

• Brak zmian od poprzedniej wersji alfa.

Wersja 1.5.0-alpha01

27 lipca 2022 roku

androidx.annotation:annotation:1.5.0-alpha01 został zwolniony. Wersja 1.5.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

• Biblioteka adnotacji została w pełni przeniesiona do źródeł Kotlina, co umożliwiło obsługę witryn docelowych na potrzeby Kotlina i innych funkcji adnotacji zgodnych z Kotlinem.

Wersja 1.4.0

Wersja 1.4.0

15 czerwca 2022 r.

androidx.annotation:annotation:1.4.0 został zwolniony. 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ę z użyciem @file. W związku z tym biblioteka Annotation jest teraz zależna od standardowej biblioteki Kotlin.
• @ReturnThis (b/140249763): zapewnia, że metody zastępujące tę metodę muszą zwracać tę samą instancję (przeznaczone dla konstruktorów itp.)
• @OpenForTesting (b/141539024): klasy i metody Kotlina oznaczone jako „open” mogą być opatrzone tą adnotacją, a lint zadba o to, aby klasa była tylko podklasą (a metody tylko zastąpione) w testach jednostkowych.
• @DeprecatedSinceApi (b/37116481): wskazuje, że adnotowana metoda (lub klasa albo pole) jest częścią biblioteki backport dla interfejsu API platformy, która nie jest już potrzebna na danym poziomie interfejsu API.
• @EmptySuper: oznacza, że ta metoda jest zdefiniowana jako pusta, więc podczas zastępowania nie musisz jej wywoływać (w istocie nie powinna być wywoływana, ponieważ może zawierać na przykład sprawdzanie zgodności wstecznej).

Wersja 1.4.0-rc01

1 czerwca 2022 r.

androidx.annotation:annotation:1.4.0-rc01 został zwolniony. Wersja 1.4.0-rc01 zawiera te zatwierdzenia.

• Interfejs API i funkcjonalność zostały sfinalizowane do wydania.

Wersja 1.4.0-beta01

18 maja 2022 r.

androidx.annotation:annotation:1.4.0-beta01 został zwolniony. Wersja 1.4.0-beta01 zawiera te commity.

• Brak zmian od ostatniej wersji alfa. Interfejs API został zablokowany w wersji beta.

Wersja 1.4.0-alpha02

9 lutego 2022 r.

androidx.annotation:annotation:1.4.0-alpha02 został zwolniony. Wersja 1.4.0-alpha02 zawiera te commity.

Nowe funkcje

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

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

• @OpenForTesting (b/141539024): klasy i metody Kotlina oznaczone jako „open” mogą być opatrzone tą adnotacją, a lint zadba o to, aby klasa była tylko podklasą (a metody tylko zastąpione) w testach jednostkowych.

• @DeprecatedSinceApi (b/37116481): oznacza, że adnotowana metoda (lub klasa albo pole) jest częścią biblioteki backport dla interfejsu API platformy, która nie jest już potrzebna na danym poziomie interfejsu API.

• @EmptySuper: oznacza, że ta metoda jest zdefiniowana jako pusta, więc podczas zastępowania nie musisz jej wywoływać (w istocie nie powinna być wywoływana, ponieważ może zawierać na przykład sprawdzanie zgodności wstecznej).

Wersja 1.4.0-alpha01

15 grudnia 2021 roku

androidx.annotation:annotation:1.4.0-alpha01 został zwolniony. Wersja 1.4.0-alpha01 zawiera te commity.

Zmiany w interfejsie API

• Adnotacje RestrictTo zostały przeniesione do źródeł Kotlin (Ia6336)

Wersja 1.3.0

Wersja 1.3.0

3 listopada 2021 r.

androidx.annotation:annotation:1.3.0 został zwolniony. Wersja 1.3.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.2.0

• @Discouraged adnotacja do oznaczania interfejsów API, których nie można w uzasadniony sposób wycofać, ale które mają znaczny negatywny wpływ na wydajność i nie powinny być wywoływane w normalnym kodzie produkcyjnym
• @Context adnotacja do oznaczania ogólnych kontekstów, aby ułatwić deweloperom migrację do nowych interfejsów API
• Adnotacja @GravityInt do oznaczania elementów zawierających wartości grawitacji zapakowane w całe liczby
• Wycofane @InspectableProperty na rzecz @Attribute w przypadku androidx.resourceinspection

Wersja 1.3.0-rc01

27 października 2021 roku

androidx.annotation:annotation:1.3.0-rc01 został zwolniony. Wersja 1.3.0-rc01 zawiera te commity.

Wersja 1.3.0-beta01

29 września 2021 r.

androidx.annotation:annotation:1.3.0-beta01 został zwolniony. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Wymagaj wyjaśnienia w polu „message” (wiadomość) dla @Discouraged. (I3390f)
• Dodawanie adnotacji @Discouraged do elementów, których używanie jest odradzane. (Ib2549)
• Ustaw widoczność adnotacji RestrictTo w wyskakującym okienku dokumentów w Studio (Ie8e1a, b/183134648)

Poprawki błędów

• Dodaj adnotację kontekstu, aby oznaczać konteksty ogólne, dzięki czemu deweloperzy będą mogli łatwiej migrować do nowych interfejsów API. (Ie581a)

Wersja 1.3.0-alpha01

24 marca 2021 r.

androidx.annotation:annotation:1.3.0-alpha01 został zwolniony. Wersja 1.3.0-alpha01 zawiera te commity.

Zmiany w interfejsie API

• Wycofane środowisko wykonawcze @InspectableProperty zostało zastąpione środowiskiem @Attribute w wersji androidx.resourceinspection. (Ic0eff)
• Dodano adnotację @GravityInt do oznaczania elementów zawierających wartości grawitacji zapakowane w liczby całkowite. (Ifcaa4, b/180620048)

Annotation-Experimental Version 1.5

Wersja 1.5.0-beta01

9 kwietnia 2025 r.

androidx.annotation:annotation-experimental:1.5.0-beta01 został zwolniony. Wersja 1.5.0-beta01 zawiera te komity.

Ważne zmiany

• Ta biblioteka jest teraz przeznaczona dla poziomu języka Kotlin 2.0 i wymaga pakietu KGP w wersji 2.0.0 lub nowszej (Idb6b5).

Wersja 1.5.0-alpha01

21 sierpnia 2024 r.

androidx.annotation:annotation-experimental:1.5.0-alpha01 został zwolniony. Wersja 1.5.0-alpha01 zawiera te komity.

Zmiany w interfejsie API

• Dodaj message do RequiresOptIn, aby dopasować adnotację Kotlin stdlib do domyślnej wartości pustego ciągu. (I1f50e)

Adnotacja – wersja eksperymentalna 1.4

Wersja 1.4.1

3 kwietnia 2024 r.

androidx.annotation:annotation-experimental:1.4.1 został zwolniony. Wersja 1.4.1 zawiera te komity.

Poprawki błędów

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

Wersja 1.4.0

24 stycznia 2024 r.

androidx.annotation:annotation-experimental:1.4.0 został zwolniony. Wersja 1.4.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.3.0

• Dodaj obsługę Kotlina na wielu platformach
• Poprawić zgodność z Kotlinem 2.0
• wyświetlanie ostrzeżeń w przypadku użycia w języku Java właściwości Kotlina z eksperymentalnymi adnotacjami (I8bd43);
• Poprawka dotycząca umieszczania adnotacji autokorekcji w metodach Kotlina (Id7a41)

Wersja 1.4.0-rc01

10 stycznia 2024 r.

androidx.annotation:annotation-experimental:1.4.0-rc01 został zwolniony. Wersja 1.4.0-rc01 nie zawiera żadnych zmian w stosunku do poprzedniej wersji.

Wersja 1.4.0-beta01

13 grudnia 2023 r.

androidx.annotation:annotation-experimental:1.4.0-beta01 został zwolniony. Nie ma żadnych zmian od poprzedniej wersji.

Wersja 1.4.0-alpha01

29 listopada 2023 r.

androidx.annotation:annotation-experimental:1.4.0-alpha01 został zwolniony. Wersja 1.4.0-alpha01 zawiera te commity.

Poprawki błędów

• Tymczasowe usunięcie sugestii automatycznych na poziomie klasy, aby obejść problem b/301598518. (Id98b2)
• wyświetlanie ostrzeżeń w przypadku użycia w języku Java właściwości Kotlina z eksperymentalnymi adnotacjami (I8bd43);
• Poprawka dotycząca umieszczania adnotacji autokorekcji w metodach Kotlina (Id7a41)

Wersja 1.4.0-dev01

8 lutego 2023 r.

androidx.annotation:annotation-experimental:1.4.0-dev01 został zwolniony. Wersja 1.4.0-dev01 zawiera te commity.

• Annotation-experimental włączyło Kotlin multiplatformowy w wersji 1.4.0-dev01 w wersji dla programistów.

Annotation-Experimental Version 1.3.1

Wersja 1.3.1

21 czerwca 2023 r.

androidx.annotation:annotation-experimental:1.3.1 został zwolniony. Wersja 1.3.1 zawiera te zatwierdzenia.

Poprawki błędów

• Umieść adnotację na początku listy modyfikatorów podczas stosowania automatycznej korekty błędów lint. (b/251172715)
• Użycie kontroli lint, aby zniechęcić do używania androidx.annotation.RequiresOptIn w źródłach Kotlina (b/241097743)

Annotation-Experimental Version 1.3.0

Wersja 1.3.0

7 września 2022 roku

androidx.annotation:annotation-experimental:1.3.0 został zwolniony. Wersja 1.3.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.2.0

• Dodanie obsługi @androidx.annotation.OptIn na poziomie pakietu (I24d58)
• Zmiana zależności od standardowej biblioteki Kotlina na typ interfejsu API zamiast tylko do kompilacji. Oznacza to, że wszyscy klienci biblioteki Annotation-Experimental będą uwzględniać standardową bibliotekę Kotlin w swoich zależnościach transitive.

Wersja 1.3.0-rc01

24 sierpnia 2022 r.

androidx.annotation:annotation-experimental:1.3.0-rc01 został zwolniony. Wersja 1.3.0-rc01 zawiera te commity.

• Brak zmian w porównaniu z poprzednią wersją. Implementacja została zamrożona w wersji RC.

Wersja 1.3.0-beta01

10 sierpnia 2022 r.

androidx.annotation:annotation-experimental:1.3.0-beta01 został zwolniony. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

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

Wersja 1.3.0-alpha01

27 lipca 2022 roku

androidx.annotation:annotation-experimental:1.3.0-alpha01 został zwolniony. Wersja 1.3.0-alpha01 zawiera te commity.

Zmiany w interfejsie API

• Dodanie obsługi @androidx.annotation.OptIn na poziomie pakietu (I24d58)

Annotation-Experimental Version 1.2.0

Wersja 1.2.0

15 grudnia 2021 roku

androidx.annotation:annotation-experimental:1.2.0 został zwolniony. 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.

androidx.annotation:annotation-experimental:1.2.0-rc01 został zwolniony. Wersja 1.2.0-rc01 zawiera te zatwierdzenia.

Brak zmian w stosunku do wersji beta.

Wersja 1.2.0-beta01

17 listopada 2021 r.

androidx.annotation:annotation-experimental:1.2.0-beta01 został zwolniony. Wersja 1.2.0-beta01 zawiera te commity.

Zmiany w interfejsie API

Interfejsy API zostały sfinalizowane w wersji beta.

Annotation-Experimental Version 1.2.0-alpha01

30 czerwca 2021 r.

androidx.annotation:annotation-experimental:1.2.0-alpha01 został zwolniony. Wersja 1.2.0-alpha01 zawiera te commity.

Nowe funkcje

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

Wersja 1.2.0

Wersja 1.2.0

24 marca 2021 r.

androidx.annotation:annotation:1.2.0 został zwolniony. Wersja 1.2.0 zawiera te zatwierdzenia.

Najważniejsze zmiany od wersji 1.1.0

• Dodano adnotację @ChecksSdkIntAtLeast, która może służyć do identyfikowania metod lub pól służących do ograniczania dostępu na poziomie pakietu SDK i spełniania wymagań kontroli NewApi.
• Dodano adnotację @DoNotInline, która jest połączona z regułą Proguard, aby uniemożliwić wstawianie elementów podczas optymalizacji.
• Różne adnotacje są teraz opatrzone znacznikiem @Documented, aby wyświetlały się w dokumentacji dla adnotowanych członków.

Wersja 1.2.0-rc01

24 lutego 2021 r.

androidx.annotation:annotation:1.2.0-rc01 został zwolniony. Wersja 1.2.0-rc01 zawiera te zatwierdzenia.

Wersja 1.2.0-beta01

13 stycznia 2021 r.

androidx.annotation:annotation:1.2.0-beta01 został zwolniony. Wersja 1.2.0-beta01 zawiera te commity.

Zmiany w interfejsie API

• Nowa adnotacja @DoNotInline, która instruuje optymalizatory kodu (np. Proguard, R8), aby nie wstawiały wstawiały adnotowanej metody. (I3dfe8, b/141326133)

Wersja 1.2.0-alpha01

14 maja 2020 r.

androidx.annotation:annotation:1.2.0-alpha01 został zwolniony. Wersja 1.2.0-alpha01 zawiera te commity.

Nowe funkcje

• Dodano adnotację @ChecksSdkIntAtLeast. Dzięki temu androidx i użytkownicy mogą dodawać adnotacje do metod i pól, które reprezentują sprawdzenie SDK_INT. (I89a54, b/120255046)

Annotation-Experimental Version 1.1.0

Wersja 1.1.0

7 kwietnia 2021 r.

androidx.annotation:annotation-experimental:1.1.0 został zwolniony. Wersja 1.1.0 zawiera te zatwierdzenia.

Najważniejsze zmiany od wersji 1.0.0

• Eksperymentalne adnotacje Jetpacka zostały przepisane w języku Kotlin, aby zapewnić obsługę wielu klas znaczników i poprawić obsługę wycofanych elementów.
• Dodano adnotacje RequiresOptIn i OptIn, aby zapewnić zgodność z językiem Kotlin. Wycofano adnotacje Experimental i UsesExperimental.

Wersja 1.1.0-rc02

24 marca 2021 r.

androidx.annotation:annotation-experimental:1.1.0-rc02 został zwolniony. Wersja 1.1.0-rc02 zawiera te zatwierdzenia.

Poprawki błędów

• Dodano reguły Proguard, aby zapewnić, że optymalizacja kodu nie będzie ostrzegać o brakujących meta-annotacjach Kotlina.

Wersja 1.1.0-rc01

10 marca 2021 r.

androidx.annotation:annotation-experimental:1.1.0-rc01 został zwolniony. Wersja 1.1.0-rc01 zawiera te zatwierdzenia.

Brak zmian od poprzedniej wersji beta.

Wersja 1.1.0-beta01

27 stycznia 2021 r.

androidx.annotation:annotation-experimental:1.1.0-beta01 został zwolniony. Wersja 1.1.0-beta01 zawiera te commity.

Zmiany w interfejsie API

• Wersja androidx adnotacji eksperymentalnej została wycofana, aby zapewnić zgodność z Kotlin. Została ona zastąpiona wariantem androidx adnotacji RequiresOptIn, a linter obsługujący język Java został zaktualizowany, aby obsługiwał zarówno nową adnotację Kotlina, jak i nowy wariant androidx. (I52495, b/151331381)

Wersja 1.1.0-alpha01

22 lipca 2020 r.

androidx.annotation:annotation-experimental:1.1.0-alpha01 został zwolniony. Wersja 1.1.0-alpha01 zawiera te commity.

Nowe funkcje

• Eksperymentalna biblioteka adnotacji jest teraz napisana w Kotlinie, ale nie wymaga dodania standardowej biblioteki Kotlin jako zależności. Zawiera on plik Proguard, który umożliwia usuwanie zbędnych metadanych Kotlina z projektów, które korzystają tylko z języka 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 są publikowane bez zmian od 1.0.0-rc01. Wersja 1.0.0 zawiera te zatwierdzenia:

Główne funkcje wersji 1.0.0

• Wymuszanie semantyki Kotlina @Experimental w kodzie źródłowym Java za pomocą Linta
• adnotacje Java, które zapewniają działanie podobne do adnotacji @Experimental i @UseExperimental w Kotlinie, bez konieczności korzystania z 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 są dostępne. Wersja 1.0.0-rc01 zawiera te zatwierdzenia:

Znane problemy

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

Annotation-Experimental Version 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 są publikowane bez zmian od wersji 1.0.0-alpha01. Wersja 1.0.0-beta01 zawiera te commity:

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 są dostępne. To są kompilacje uwzględnione w annotation-experimental 1.0.0-alpha01, a to są kompilacje uwzględnione w annotation-experimental-lint 1.0.0-alpha01.

Nowe funkcje

• Eksperymentalna biblioteka adnotacji Jetpack udostępnia implementację eksperymentalnych znaczników interfejsu API w języku Kotlin, która jest zgodna z Java. Element -lint zawiera implementację eksperymentalnych ograniczeń użytkowania na podstawie Lint i egzekwuje ograniczenia dotyczące użycia Javy w naszych natywnych eksperymentalnych znacznikach interfejsu API w Kotlinie.

• Jeśli używasz artefaktu annotation-experimental jako zależności, reguły Lint określone przez artefakt annotation-experimental-lint zostaną zastosowane automatycznie.

Wersja 1.1.0

Wersja 1.1.0

5 czerwca 2019 r.

androidx.annotation:annotation:1.1.0 jest wydana bez zmian w porównaniu z 1.1.0-rc01.

Wersja 1.1.0-rc01

7 maja 2019 r.

androidx.annotation:annotation:1.1.0-rc01 jest publikowany bez zmian w porównaniu z wersją 1.1.0-beta01. Zmiany zawarte w tej wersji znajdziesz tutaj.

Wersja 1.1.0-beta01

3 kwietnia 2019 r.

androidx.annotation:annotation:1.1.0-beta01 został zwolniony. Zmiany zawarte w tej wersji znajdziesz tutaj.

Nowe funkcje

• Nowa adnotacja @InspectableProperty, która obsługuje nowe interfejsy API do inspekcji widoku dodanych w Androidzie 10. Tę adnotację można zastosować do getterów w widokach lub innych elementach interfejsu. Narzędzia do generowania kodu mogą używać tego typu obiektów 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 odwoływaniem.

Zmiany w interfejsie API

• Zmiana powodująca przerwanie działania: @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ązano w ten sposób problem z korzystaniem z tej adnotacji w modułach biblioteki. (b/128352521)

Wersja 1.1.0-alpha02

13 marca 2019 r.

androidx.annotation:annotation:1.1.0-alpha02 został zwolniony. Pełną listę zatwierdzeń uwzględnionych w tej wersji znajdziesz tutaj.

Nowe funkcje

• Nowy zakres ograniczeń interfejsu API: RestrictTo.Scope.LIBRARY_GROUP_PREFIX. Ogranicza ona użycie do kodu w pakietach, których grupy mają ten sam prefiks grupy biblioteki do ostatniej . (kropka). Na przykład biblioteki foo.bar:lib1 i foo.baz:lib2 mają wspólny prefiks foo, więc mogą korzystać z interfejsów API należących do siebie nawzajem, które są ograniczone do tego zakresu. Podobnie com.foo.bar:lib1 i com.foo.baz:lib2 mają 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 ograniczonym dostępem, ponieważ ma tylko wspólny prefiks com., ale nie ma go w całości do ostatniego znaku ..

Wersja 1.1.0-alpha01

30 stycznia 2019 r.

androidx.annotation:annotation 1.1.0-alpha01 został zwolniony.

Nowe funkcje

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

Wersja 1.0.2

Wersja 1.0.2

25 lutego 2019 r.

androidx.annotation:annotation 1.0.2 został zwolniony.

Poprawki błędów

• Popraw reguły R8/ProGuard, które są osadzone w pliku JAR. Te elementy odwoływały się nieprawidłowo do starych typów android.support.annotation zamiast do androidx.annotation. Uwaga: ta zmiana miałaby wpływ na kompilacje tylko wtedy, gdy nie używasz getDefaultProguardFile, ponieważ te domyślne reguły zawierały też prawidłowe reguły dla obu pakietów. (aosp/891685)
• Dodaj regułę R8 lub ProGuard, która wyraźnie zachowuje adnotację @Keep. Dzięki temu ProGuard nie usuwa adnotacji z typów przed faktycznym uwzględnieniem jej semantyki. Uwaga: ta zmiana miałaby wpływ na kompilacje tylko wtedy, gdy nie używasz getDefaultProguardFile, ponieważ te domyślne reguły zawierały też prawidłowe reguły dla obu pakietów. (aosp/903818)