Adnotacja

  
Udostępniaj metadane, aby ułatwić narzędziom i innym deweloperom zrozumienie kodu aplikacji.

Ta tabela zawiera wszystkie artefakty w grupie androidx.annotation.

Artefakt Wersja stabilna Kandydat do wydania Wersja Beta Wydanie alfa
adnotacja 1.8.0 - - 1.9.0-alfa01
eksperymentalna-adnotacja 1.4.1 - - -
Ta biblioteka została ostatnio zaktualizowana: 26 czerwca 2024 r.

Deklarowanie zależności

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

W pliku build.gradle aplikacji lub modułu dodaj zależności artefaktów, których potrzebujesz:

Odlotowe

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

Kotlin

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

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

Opinia

Twoja opinia pomoże nam ulepszyć Jetpack. Daj nam znać, jeśli odkryjesz nowe wydania lub masz pomysły na ulepszenie tej biblioteki. Zanim utworzysz nową bibliotekę, przejrzyj istniejące problemy w tej bibliotece. Możesz oddać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Tworzenie nowego numeru

Więcej informacji znajdziesz w dokumentacji narzędzia do śledzenia problemów.

Wersja 1.9

Wersja 1.9.0-alpha01

26 czerwca 2024 r.

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

Treści tłumaczone przez użytkowników zewnętrznych

  • Dodano obsługę celu wieloplatformowego linuxArm64 (dziękujemy Jake'owi Whartonowi!)

Wersja 1.8

Wersja 1.8.0

14 maja 2024 r.

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

Ważne zmiany wprowadzone od wersji 1.7.0

  • Dodano adnotację @ReplaceWith do szybkiego zamienników wycofanych interfejsów API
  • Adnotacja @MainThread została przeniesiona do wspólnego zbioru źródłowego.

Wersja 1.8.0-rc01

1 maja 2024 r.

Usługa androidx.annotation:annotation-*:1.8.0-rc01 została zwolniona. Wersja 1.8.0-rc01 nie zawiera żadnych zmian od poprzedniej wersji beta.

Wersja 1.8.0-beta02

17 kwietnia 2024 r.

Usługa androidx.annotation:annotation-*:1.8.0-beta02 została zwolniona. Wersja 1.8.0-beta02 nie zawiera żadnych zmian od poprzedniej wersji.

Wersja 1.8.0-beta01

3 kwietnia 2024 r.

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

Nowe funkcje

  • Adnotacja ReplaceWith jest teraz stabilna w interfejsie API, ale powiązane z nią sprawdzanie lintowania z funkcją autopoprawki nie zostało jeszcze wysłane

Wersja 1.8.0-alpha02

20 marca 2024 r.

Wersja androidx.annotation:annotation-*:1.8.0-alpha02 została udostępniona bez istotnych zmian. Wersja 1.8.0-alfa02 zawiera te zatwierdzenia.

Wersja 1.8.0-alpha01

21 lutego 2024 r.

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

Zmiany interfejsu API

  • Dodaliśmy adnotację @ReplaceWith, aby umożliwić ekspresowe zamienniki wycofanych interfejsów API. (I38db3, b/322373864)

Treści tłumaczone z zewnątrz

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

Wersja 1.7

Wersja 1.7.1

13 grudnia 2023 r.

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

Poprawki błędów

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

Wersja 1.7.0

6 września 2023 r.

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

Ważne zmiany od wersji 1.6.0

  • Obejmuje wieloplatformowe artefakty Kotlin kierowane na platformy iOS, Linux i macOS.
  • Możesz teraz używać adnotacji w projektach KMM. Pamiętaj, że kierowanie adnotacji na platformy inne niż Android jest nadal w fazie eksperymentalnej, ale postanowiliśmy połączyć ich wersje, by ułatwić deweloperom ich wypróbowanie. W szczególności niektóre adnotacje mogą pojawiać się między kodem wspólnym a konkretnym dla danej platformy w fazie alfa, gdy będziemy finalizować granice.

Wersja 1.7.0-rc01

23 sierpnia 2023 r.

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

Nie zawiera ona żadnych zmian w porównaniu z poprzednią wersją beta.

Wersja 1.7.0-beta01

9 sierpnia 2023 r.

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

Nowe funkcje

  • Ustabilizowane interfejsy API na potrzeby wersji

Wersja 1.7.0-alpha03

26 lipca 2023 r.

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

Poprawki błędów

  • Publikacja Maven POM zawiera jako zależność domyślny artefakt wieloplatformowy kierowany na JVM

Wersja 1.7.0-alpha02

24 marca 2023 r.

Usługa androidx.annotation:annotation-*:1.7.0-alpha02 została zwolniona.

Poprawki błędów

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

Wersja 1.7.0-alpha01

22 marca 2023 r.

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

Nowe funkcje

  • Obejmuje wieloplatformowe artefakty Kotlin kierowane na platformy iOS, Linux i macOS.
  • Możesz teraz używać adnotacji w projektach KMM. Pamiętaj, że kierowanie adnotacji na platformy inne niż Android jest nadal w fazie eksperymentalnej, ale postanowiliśmy połączyć ich wersje, by ułatwić deweloperom ich wypróbowanie. W szczególności niektóre adnotacje mogą pojawiać się między kodem wspólnym a konkretnym dla danej platformy w fazie alfa, gdy będziemy finalizować granice.

Wersja 1.6

Wersja 1.6.0

22 lutego 2023 roku

androidx.annotation:annotation:1.6.0 i androidx.annotation:annotation-jvm:1.6.0 zostały udostępnione. Wersja 1.6.0 zawiera te zatwierdzenia.

Ważne zmiany wprowadzone od wersji 1.5.0

  • Dodaje adnotację @RequiresExtension, aby wskazać, że interfejs API wymaga określonej wersji określonego pakietu SDK rozszerzenia (I5e4fe)
  • Przekonwertowano bibliotekę adnotacji, tworząc wieloplatformowy łańcuch narzędzi Kotlin (I3be8d)

Wersja 1.6.0-rc01

8 lutego 2023 r.

androidx.annotation:annotation:1.6.0-rc01 i androidx.annotation:annotation-jvm:1.6.0-rc01 zostały udostępnione. Wersja 1.6.0-rc01 zawiera te zatwierdzenia.

  • Adnotacja została ustabilizowana w wersji 1.6.0-rc01.

Wersja 1.6.0-beta01

25 stycznia 2023 r.

Wersje androidx.annotation:annotation:1.6.0-beta01 i androidx.annotation:annotation-jvm:1.6.0-beta01 zostały zwolnione bez zmian od 1.6.0-alpha01.

Wersja 1.6.0-alpha01

11 stycznia 2023 r.

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

Wersja 1.6.0-dev01

8 lutego 2023 r.

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

  • Dzięki adnotacjom funkcja Kotlin w wersji 1.6.0-dev01 została udostępniona na wielu platformach w wersji testowej dla programistów.

Nowe funkcje

  • Dodaje adnotację @RequiresExtension, aby wskazać, że interfejs API wymaga określonej wersji pakietu SDK danego rozszerzenia. (I5e4fe)
  • Przekonwertowano bibliotekę adnotacji, tworząc wieloplatformowy łańcuch narzędzi Kotlin (I3be8d)

Wersja 1.5.0

Wersja 1.5.0

21 września 2022 r.

Usługa androidx.annotation:annotation:1.5.0 została zwolniona. Wersja 1.5.0 zawiera te zatwierdzenia.

Ważne zmiany wprowadzone od wersji 1.4.0

  • Biblioteka adnotacji została w pełni przeniesiona do źródeł Kotlin, co zaowocowało obsługą docelowych witryn użycia specyficznych dla Kotlin i innych funkcji adnotacji zgodnych z Kotlin.

Wersja 1.5.0-rc01

7 września 2022 roku

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

  • Brak zmian w stosunku do poprzedniej wersji beta (1.5.0).

Wersja 1.5.0-beta01

24 sierpnia 2022 r.

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

  • Brak zmian w porównaniu z poprzednią wersją. Powierzchnia interfejsu API została zablokowana dla wersji beta.

Wersja 1.5.0-alpha02

10 sierpnia 2022 r.

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

  • Brak zmian od poprzedniej wersji alfa.

Wersja 1.5.0-alpha01

27 lipca 2022 roku

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

Nowe funkcje

  • Biblioteka adnotacji została w pełni przeniesiona do źródeł Kotlin, co zaowocowało obsługą docelowych witryn użycia specyficznych dla Kotlin i innych funkcji adnotacji zgodnych z Kotlin.

Wersja 1.4.0

Wersja 1.4.0

15 czerwca 2022 r.

Usługa androidx.annotation:annotation:1.4.0 została zwolniona. Wersja 1.4.0 zawiera te zatwierdzenia.

Ważne zmiany wprowadzone od wersji 1.3.0

  • Rozszerzenie @RestrictTo zostało przeniesione do źródeł Kotlin i obsługuje teraz witrynę użycia @file. W związku z tym biblioteka Adnotacji bazuje na standardowej bibliotece Kotlin.
  • @ReturnThis (b/140249763): gwarantuje, że metody zastępowania w tej metodzie muszą zwracać tę samą instancję (przeznaczone dla konstruktorów itp.)
  • @OpenForTesting (b/141539024): Klasy i metody Kotlin oznaczone jako „otwarte” można opatrzyć adnotacją za pomocą adnotacji. Lint zapewni, że w testach jednostkowych tylko ta klasa zostanie podklasa (i tylko metody zostaną zastąpione)
  • @DeprecatedSinceApi (b/37116481): oznacza, że metoda (lub klasa lub pole) z adnotacjami jest częścią biblioteki backendu dla interfejsu API platformy, która nie jest już potrzebna na danym poziomie interfejsu API.
  • @EmptySuper: wskazuje, że ta metoda jest zdefiniowana jako pusta, więc przy zastępowaniu nie trzeba jej wywoływać (a w rzeczywistości nie należy jej wywoływać, ponieważ może na przykład zawierać sprawdzanie zgodności wstecznej).

Wersja 1.4.0-rc01

1 czerwca 2022 r.

Usługa androidx.annotation:annotation:1.4.0-rc01 została zwolniona. Wersja 1.4.0-rc01 zawiera te zatwierdzenia.

  • Wdrożenie interfejsu API i jego funkcji zostało zakończone.

Wersja 1.4.0-beta01

18 maja 2022 r.

Usługa androidx.annotation:annotation:1.4.0-beta01 została zwolniona. Wersja 1.4.0-beta01 zawiera te zatwierdzenia.

  • Brak zmian od ostatniej wersji alfa. Dostęp do interfejsu API został zablokowany dla wersji beta.

Wersja 1.4.0-alpha02

9 lutego 2022 r.

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

Nowe funkcje

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

  • @ReturnThis (b/140249763): gwarantuje, że metody zastępowania w tej metodzie muszą zwracać tę samą instancję (przeznaczone dla konstruktorów itp.).

  • @OpenForTesting (b/141539024): do tej adnotacji można dodać adnotacje o klasach i metodach Kotlin oznaczonych jako „otwarte”. Lint sprawi, że z testów jednostkowych do tej klasy zostanie przypisana tylko podklasa (i tylko metody zostaną zastąpione)

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

  • @EmptySuper: wskazuje, że ta metoda jest zdefiniowana jako pusta, więc przy zastępowaniu nie trzeba jej wywoływać (a w rzeczywistości nie należy jej wywoływać, ponieważ może na przykład zawierać sprawdzanie zgodności wstecznej).

Wersja 1.4.0-alpha01

15 grudnia 2021 roku

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

Zmiany interfejsu API

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

Wersja 1.3.0

Wersja 1.3.0

3 listopada 2021 r.

Usługa androidx.annotation:annotation:1.3.0 została zwolniona. Wersja 1.3.0 zawiera te zatwierdzenia.

Ważne zmiany wprowadzone od wersji 1.2.0

  • Adnotacja @Discouraged do oznaczania interfejsów API, których nie można w uzasadniony sposób wycofać, ale mają one znaczny negatywny wpływ na wydajność i nie powinny być wywoływane w zwykłym kodzie produkcyjnym
  • Adnotacja @Context do oznaczania ogólnych kontekstów, co ułatwia programistom migrację do nowych interfejsów API
  • Adnotacja @GravityInt do oznaczania elementów zawierających wartości grawitacji ułożonych w liczby całkowite
  • Wycofano: @InspectableProperty na rzecz @Attribute w przypadku: androidx.resourceinspection

Wersja 1.3.0-rc01

27 października 2021 roku

Usługa androidx.annotation:annotation:1.3.0-rc01 została zwolniona. Wersja 1.3.0-rc01 zawiera te zatwierdzenia.

Wersja 1.3.0-beta01

29 września 2021 r.

Usługa androidx.annotation:annotation:1.3.0-beta01 została zwolniona. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

Zmiany interfejsu API

  • Wymagaj wyjaśnienia w polu „message” w przypadku @Odradzane. (I3390f)
  • dodawanie adnotacji @Odradzane w celu oznaczania elementów, których odradzamy; (IB2549)
  • Pokazuj adnotację RestrictTo w wyskakującym okienku z dokumentami w Studio (Ie8e1a, b/183134648)

Poprawki błędów

  • Dodaj adnotację kontekstową, aby oznaczyć ogólne konteksty i ułatwić programistom migrację do nowych interfejsów API. (IE581a).

Wersja 1.3.0-alpha01

24 marca 2021 r.

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

Zmiany interfejsu API

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

Adnotacja-eksperymentalna wersja 1.4

Wersja 1.4.1

3 kwietnia 2024 r.

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

Poprawki błędów

  • Popraw użycie funkcji isKotlin, aby uniknąć przypadkowego uruchomienia 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.

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

Wersja 1.3.0-beta01

10 sierpnia 2022 r.

Usługa androidx.annotation:annotation-experimental:1.3.0-beta01 została zwolniona. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

  • Bez zmian w stosunku do wersji alfa. Ta biblioteka została stabilna pod kątem wersji beta.

Wersja 1.3.0-alpha01

27 lipca 2022 roku

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

Zmiany interfejsu API

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

Adnotacja-eksperymentalna wersja 1.2.0

Wersja 1.2.0

15 grudnia 2021 roku

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

Ważne zmiany od wersji 1.1.0

Ta biblioteka jest teraz kierowana na język Java 8.

Wersja 1.2.0-rc01

1 grudnia 2021 r.

Usługa androidx.annotation:annotation-experimental:1.2.0-rc01 została zwolniona. Wersja 1.2.0-rc01 zawiera te zatwierdzenia.

Bez zmian w stosunku do wersji beta.

Wersja 1.2.0-beta01

17 listopada 2021 r.

Usługa androidx.annotation:annotation-experimental:1.2.0-beta01 została zwolniona. Wersja 1.2.0-beta01 zawiera te zatwierdzenia.

Zmiany interfejsu API

Interfejsy API zostały dodane do wersji beta.

Adnotacja-eksperymentalna wersja 1.2.0-alfa01

30 czerwca 2021 r.

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

Nowe funkcje

  • Biblioteka jest teraz kierowana na język Java 8

Wersja 1.2.0

Wersja 1.2.0

24 marca 2021 r.

Usługa androidx.annotation:annotation:1.2.0 została zwolniona. Wersja 1.2.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.1.0

  • Dodano adnotację @ChecksSdkIntAtLeast, której można używać do identyfikowania metod lub pól używanych do bramki dostępu na poziomie SDK i sprawdzania 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ł wycofany, aby zapewnić zgodność z narzędziem Kotlin. Zastąpiliśmy ją wariantem Androidax adnotacji RequestsOptIn, a linter obsługujący język Java (dotyczy to zarówno nowej adnotacji Kotlin, jak i nowego wariantu Androidax) został zaktualizowany. (I52495, b/151331381)

Wersja 1.1.0-alpha01

22 lipca 2020 r.

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

Nowe funkcje

  • Eksperymentalna biblioteka adnotacji jest teraz napisana w Kotlin, ale nie wymaga uwzględniania standardowej biblioteki Kotlin jako zależności. Zawiera on plik Proguard, który umożliwia usuwanie zbędnych metadanych Kotlin z projektów wykorzystujących wyłącznie język programowania Java.
  • @UseExperimental obsługuje teraz wiele klas znaczników (aosp/1185577, b/145137892)

Adnotacja-eksperymentalna wersja 1.0.0

Adnotacja-eksperymentalna wersja 1.0.0

7 listopada 2019 r.

Wersje androidx.annotation:annotation-experimental:1.0.0 i androidx.annotation:annotation-experimental-lint:1.0.0 zostały udostępnione bez zmian od 1.0.0-rc01. Wersja 1.0.0 zawiera te zatwierdzenia.

Główne funkcje 1.0.0

  • Egzekwowanie semantyki @Experimental Kotlin w kodzie źródłowym Javy w oparciu o Lint
  • Adnotacje w języku Java, które zapewniają takie samo działanie jak adnotacje @Experimental i @UseExperimental Kotlina bez konieczności uzależnienia się od usługi Kotlin

Adnotacja-eksperymentalna wersja 1.0.0-rc01

23 października 2019 r.

androidx.annotation:annotation-experimental:1.0.0-rc01 i androidx.annotation:annotation-experimental-lint:1.0.0-rc01 zostały udostępnione. Wersja 1.0.0-rc01 zawiera te zatwierdzenia.

Znane problemy

Jeśli używasz stabilnej wersji Studio 3.5, ostrzeżenia z wykrywacza lintowania @Experimental nie są wyświetlane w IDE o nieprawidłowym użyciu adnotacji w języku Java w kotlin @Experimental. Zobacz b/140640322.

Adnotacja-eksperymentalna wersja 1.0.0-beta01

9 października 2019 r.

androidx.annotation:annotation-experimental:1.0.0-beta01 i androidx.annotation:annotation-experimental-lint:1.0.0-beta01 zostały udostępnione bez zmian od wersji 1.0.0-alpha01. Wersja 1.0.0-beta01 zawiera te zatwierdzenia.

Adnotacja-eksperymentalna wersja 1.0.0-alfa01

18 września 2019 r.

androidx.annotation:annotation-experimental:1.0.0-alpha01 i androidx.annotation:annotation-experimental-lint:1.0.0-alpha01 zostały udostępnione. To są zobowiązania uwzględnione w ramach eksperymentów dotyczących adnotacji 1.0.0-alpha01 i obejmują zobowiązania zawarte w ramach adnotacji-experimental-lint 1.0.0-alpha01

Nowe funkcje

  • Eksperymentalna biblioteka adnotacji Jetpack udostępnia zgodną z Javą implementację eksperymentalnych znaczników interfejsu API Kotlin. Artefakt -lint udostępnia opartą na Lint implementację eksperymentalnych ograniczeń użytkowania i egzekwuje ograniczenia dotyczące użycia natywnych znaczników eksperymentalnych interfejsów API Kotlin w języku Java.

  • Gdy używasz artefaktu annotation-experimental jako zależności, reguły Lint udostępnione przez 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łną listę zatwierdzeń zawartych w tej wersji znajdziesz tutaj.

Nowe funkcje

  • Nowy zakres ograniczeń interfejsu API: RestrictTo.Scope.LIBRARY_GROUP_PREFIX. Ogranicza wykorzystanie do kodu w pakietach, których grupy mają ten sam prefiks grupy bibliotek do ostatniego . (kropki). Na przykład biblioteki foo.bar:lib1 i foo.baz:lib2 mają wspólny prefiks foo, więc mogą używać wzajemnie swoich interfejsów API, które są ograniczone do tego zakresu. Podobnie w przypadku com.foo.bar:lib1 i com.foo.baz:lib2 używają 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 interfejsu API z ograniczonym dostępem, ponieważ współdzieli tylko prefiks com., a nie całkowicie do ostatniego . (kropki).

Wersja 1.1.0-alpha01

30 stycznia 2019 r.

Usługa androidx.annotation:annotation 1.1.0-alpha01 została zwolniona.

Nowe funkcje

  • Dodaliśmy adnotację @ContentView, która pozwala wskazać plik XML układu, który należy wyświetlić. Jest to obsługiwane 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ć ich semantyki. Uwaga: miałoby to wpływ na kompilacje tylko wtedy, gdy nie używasz getDefaultProguardFile, ponieważ reguły domyślne obejmowały również prawidłowe reguły dla obu pakietów. (Aosp/903818)