Adnotacja

Ta tabela zawiera wszystkie artefakty w grupie androidx.annotation.

Deklarowanie zależności

Aby dodać zależność od Adnotacji, musisz dodać repozytorium Google Maven do swojej w projektach AI. Zapoznaj się z repozytorium Google Maven. .

Dodaj zależności 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ć Jetpack. Daj nam znać, jeśli odkryjesz nowe problemy jak ulepszyć tę bibliotekę. Przyjrzyj się istniejące problemy w tej bibliotece, zanim utworzysz nową. Możesz zagłosować nad istniejącym problemem przez klikając przycisk gwiazdki.

Tworzenie nowego numeru

Zobacz dokumentację narzędzia Issue Tracker. .

Wersja 1.9

Wersja 1.9.0-alpha03

4 września 2024 r.

Usługa androidx.annotation:annotation-*:1.9.0-alpha03 została zwolniona. Wersja 1.9.0-alfa03 nie zawiera żadnych zmian od poprzedniej wersji alfa.

Wersja 1.9.0-alpha02

21 sierpnia 2024 r.

Usługa androidx.annotation:annotation-*:1.9.0-alpha02 została zwolniona. Wersja 1.9.0-alfa02 zawiera te zatwierdzenia.

Nowe funkcje

• Dodaję obsługę platformy mingwX64 (I461ca, b/349894318)
• Dodaj obsługę wieloplatformowego celu kotlin linuxArm64. (I139d3, b/338268719)

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

7 sierpnia 2024 r.

Usługa androidx.annotation:annotation-*:1.8.2 została zwolniona. Wersja 1.8.2 zawiera te zatwierdzenia.

Poprawki błędów

• Dodaję obsługę platformy mingwX64 (I461ca, b/349894318)

Wersja 1.8.1

24 lipca 2024 r.

Usługa androidx.annotation:annotation-*:1.8.1 została zwolniona. Wersja 1.8.1 zawiera te zatwierdzenia.

Poprawki błędów

• Obejmuje dodatkowe cele wieloplatformowe Kotlin: watchos, tvos.

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-alfa02

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 zdecydowaliśmy się połączyć 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 funkcje kierowania adnotacji niepochodzące z Androida są wciąż 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 dodać adnotację do tej adnotacji, a lint zapewni, że w testach jednostkowych ta klasa zostanie tylko podklasa (a 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): klasy i metody Kotlin oznaczone jako „otwarte” można dodać adnotację do tej adnotacji, a lint zapewni, że w testach jednostkowych ta klasa zostanie tylko podklasa (a 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 „wiadomość” 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 Studio (Ie8e1a, b/183134648)

Poprawki błędów

• Dodaj adnotację kontekstową, aby oznaczyć ogólne konteksty i ułatwić programistom mogą łatwiej przejść na nowe interfejsy 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 pole @InspectableProperty na rzecz @Attribute w aplikacji androidx.resourceinspection. (IC0Eff)
• Dodano adnotację @GravityInt do oznaczania elementów zawierających grawitacji wyrażonej w liczbach całkowitych. (Ifcaa4, b/180620048)

Adnotacja-eksperymentalna wersja 1.5

Wersja 1.5.0-alpha01

21 sierpnia 2024 r.

Usługa androidx.annotation:annotation-experimental:1.5.0-alpha01 została zwolniona. Wersja 1.5.0-alfa01 zawiera te zatwierdzenia.

Zmiany interfejsu API

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

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 funkcji RequiresOptIn 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.

• Brak 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 ustabilizowana na potrzeby 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 lintowania NewApi.
• 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 i OptIn, aby zapewnić zgodność z Kotlinem, a adnotacje Experimental i UsesExperimental 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ł wycofane, aby zapewnić spójność z narzędziem Kotlin. Zastąpiliśmy ją wersją Androidax Adnotacja requiredOptIn i linter obsługujący język Java został zaktualizowany do obsługują zarówno nową adnotację Kotlin, jak i nowy wariant Androidax. (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 artefakt annotation-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 @InspectablePropertydo 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łna lista zatwierdzeń zawiera tej wersji znajdziesz tutaj.

Nowe funkcje

• Nowy zakres ograniczeń interfejsu API: RestrictTo.Scope.LIBRARY_GROUP_PREFIX. it ogranicza użycie do kodu w pakietach, których grupy mają tę samą bibliotekę prefiks grupy do ostatniego . (kropki). Na przykład biblioteki foo.bar:lib1 i foo.baz:lib2 korzystają z prefiksu foo, mogą używać wzajemnie swoich interfejsów API które są ograniczone do tego zakresu. Podobnie w przypadku: com.foo.bar:lib1 oraz com.foo.baz:lib2 korzystają z prefiksu 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 interfejs API z ograniczonym dostępem, ponieważ udostępnia tylko prefiks com., a nie w całości do ostatniego . (kropka).

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 w ComponentActivity w wersjach 1.0.0-alpha04 i Fragment w wersji 1.1.0-alpha04 jako alternatywa dla użycia odpowiednio setContentView() lub zastąpienia danych onCreateView(). (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 zamiast androidx.annotation. 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/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ć jej 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)