Adnotacja

  
Udostępniaj metadane, które pomagają narzędziom i innym deweloperom zrozumieć kod Twojej aplikacji.

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

Artefakt Wersja stabilna Kandydat do publikacji Wersja Beta Wersja alfa
adnotacja 1.7.1 - - 1.8.0-alfa02
eksperymentalna z adnotacją 1.4.0 - - -
Ostatnia aktualizacja tej biblioteki: 20 marca 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:

Odlotowy

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

Kotlin

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

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 znajdziesz nowe wydania lub masz pomysły na ulepszenie tej biblioteki. Zanim utworzysz nową bibliotekę, przejrzyj problemy z tą biblioteką. Możesz oddać głos w ramach istniejącego problemu, klikając przycisk gwiazdki.

Utwórz nowy numer

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

Wersja 1.8

Wersja 1.8.0-alfa02

20 marca 2024 r.

Wersja androidx.annotation:annotation-*:1.8.0-alpha02 została opublikowana bez istotnych zmian. Wersja 1.8.0-alpha02 zawiera te zatwierdzenia.

Wersja 1.8.0-alfa01

21 lutego 2024 r.

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

Zmiany w interfejsie API

  • Dodano adnotację @ReplaceWith, która pozwala zastąpić wycofywane interfejsy API. (I38db3, b/322373864)

Treści opublikowane przez użytkowników 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.

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

Poprawki błędów

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

Wersja 1.7.0

6 września 2023 r.

Aplikacja 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.
  • Teraz możesz używać adnotacji w projektach KMM. Pamiętaj, że elementy docelowe adnotacji na urządzenia inne niż Android nadal są w fazie eksperymentalnej, ale zdecydowaliśmy się scalić wersje, aby ułatwić deweloperom ich testowanie. W szczególności w fazie rozwoju alfa niektóre adnotacje mogą się poruszać między kodem wspólnym a kodem przeznaczonym na konkretną platformę, gdy ograniczymy granice.

Wersja 1.7.0-rc01

23 sierpnia 2023 r.

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

Ta wersja nie zawiera żadnych zmian z poprzedniej wersji beta.

Wersja 1.7.0-beta01

9 sierpnia 2023 r.

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

Nowe funkcje

  • Stabilizowane interfejsy API dla wersji

Wersja 1.7.0-alfa03

26 lipca 2023 r.

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

Poprawki błędów

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

Wersja 1.7.0-alfa02

24 marca 2023 r.

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

Poprawki błędów

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

Wersja 1.7.0-alfa01

22 marca 2023 r.

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

Nowe funkcje

  • Obejmuje wieloplatformowe artefakty Kotlin kierowane na platformy iOS, Linux i macOS.
  • Teraz możesz używać adnotacji w projektach KMM. Pamiętaj, że elementy docelowe adnotacji na urządzenia inne niż Android nadal są w fazie eksperymentalnej, ale zdecydowaliśmy się scalić wersje, aby ułatwić deweloperom ich testowanie. W szczególności w fazie rozwoju alfa niektóre adnotacje mogą się poruszać między kodem wspólnym a kodem przeznaczonym na konkretną platformę, gdy ograniczymy granice.

Wersja 1.6

Wersja 1.6.0

22 lutego 2023 roku

Opublikowano 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, która informuje, że interfejs API wymaga konkretnej wersji konkretnego pakietu SDK rozszerzenia (I5e4fe).
  • Przekonwertowana biblioteka adnotacji do utworzenia za pomocą wieloplatformowego łańcucha narzędzi Kotlin (I3be8d)

Wersja 1.6.0-rc01

8 lutego 2023 r.

Opublikowano 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 do wersji 1.6.0-rc01 została ustabilizowana.

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 opublikowane bez zmian z 1.6.0-alpha01.

Wersja 1.6.0-alfa01

11 stycznia 2023 r.

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

Wersja 1.6.0-dev01

8 lutego 2023 r.

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

  • Adnotacja włączyła wieloplatformowe Kotlin w wersji przedpremierowej dla programistów w wersji 1.6.0-dev01.

Nowe funkcje

  • Dodaje adnotację @RequiresExtension, która wskazuje, że interfejs API wymaga konkretnej wersji konkretnego pakietu SDK rozszerzenia. (I5e4fe)
  • Przekonwertowana biblioteka adnotacji do utworzenia za pomocą wieloplatformowego łańcucha narzędzi Kotlin (I3be8d)

Wersja 1.5.0

Wersja 1.5.0

21 września 2022 r.

Aplikacja androidx.annotation:annotation:1.5.0 została zwolniona. 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 pozwoliło na obsługę witryn docelowych specyficznych dla Kotlin i inne funkcje adnotacji zgodne z Kotlin.

Wersja 1.5.0-rc01

7 września 2022 roku

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

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

  • Brak zmian w stosunku do poprzedniej wersji. Interfejs API został zablokowany w wersji beta.

Wersja 1.5.0-alfa02

10 sierpnia 2022 r.

Aplikacja androidx.annotation:annotation:1.5.0-alpha02 została zwolniona. Wersja 1.5.0-alpha02 zawiera te zatwierdzenia.

  • Brak zmian od poprzedniej wersji alfa.

Wersja 1.5.0-alfa01

27 lipca 2022 roku

Aplikacja androidx.annotation:annotation:1.5.0-alpha01 została zwolniona. Wersja 1.5.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Biblioteka adnotacji została w pełni przeniesiona do źródeł Kotlin, co pozwoliło na obsługę witryn docelowych specyficznych dla Kotlin i inne funkcje adnotacji zgodne z Kotlin.

Wersja 1.4.0

Wersja 1.4.0

15 czerwca 2022 r.

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

Ważne zmiany od wersji 1.3.0

  • Adres @RestrictTo został przeniesiony do źródeł Kotlin i obsługuje teraz witrynę wykorzystania @file. W rezultacie biblioteka adnotacji bazuje teraz na standardowej bibliotece Kotlin.
  • @ReturnThis (b/140249763): zapewnia, że metody zastępowania tej metody muszą zwracać tę samą instancję (przeznaczone dla monterów itp.)
  • @OpenForTesting (b/141539024): do klas i metod Kotlin oznaczonych jako „otwarte” można dodać adnotacje z tą adnotacją. Litowanie zapewni, że klasa będzie odznaczać się tylko z klasy podrzędnej (i zastąpioną tylko nią) z testów jednostkowych.
  • @DeprecatedSinceApi (b/37116481): wskazuje, ż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 w przypadku zastępowania nie musisz jej wywoływać (a w rzeczywistości nie należy jej używać, na przykład może zawierać sprawdzanie zgodności wstecznej).

Wersja 1.4.0-rc01

1 czerwca 2022 r.

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

  • Zakończyliśmy wdrażanie interfejsu API i udostępniliśmy wszystkie jego funkcje.

Wersja 1.4.0-beta01

18 maja 2022 r.

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

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

Wersja 1.4.0-alfa02

9 lutego 2022 r.

Aplikacja androidx.annotation:annotation:1.4.0-alpha02 została zwolniona. 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ępowania tej metody muszą zwracać tę samą instancję (przeznaczone dla monterów itp.)

  • @OpenForTesting (b/141539024): klasy i metody Kotlin oznaczone jako „otwarte” można dodać do adnotacji za pomocą tej adnotacji. Dzięki Litowaniu klasa będzie mieć klasyfikację podklasyczną (i tylko zastępowaną) z testów jednostkowych.

  • @DeprecatedSinceApi (b/37116481): wskazuje, ż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 w przypadku zastępowania nie musisz jej wywoływać (a w rzeczywistości nie należy jej używać, na przykład może zawierać sprawdzanie zgodności wstecznej).

Wersja 1.4.0-alfa01

15 grudnia 2021 roku

Aplikacja androidx.annotation:annotation:1.4.0-alpha01 została zwolniona. Wersja 1.4.0-alpha01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Adnotacja RestrictTo została przeniesiona do źródeł Kotlin (Ia6336)

Wersja 1.3.0

Wersja 1.3.0

3 listopada 2021 r.

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

Ważne zmiany od wersji 1.2.0

  • Adnotacja @Discouraged do oznaczania interfejsów API, których nie można wycofać, ale mają znaczny wpływ na wydajność i nie powinny być wywoływane w normalnym kodzie produkcyjnym
  • Adnotacja @Context do oznaczania ogólnego kontekstu, aby deweloperzy mogli łatwiej przejść na nowe interfejsy API
  • Adnotacja @GravityInt do oznaczania elementów zawierających wartości grawitacji ułożone w liczbach całkowitych
  • Wycofano atrybut @InspectableProperty na rzecz zasady @Attribute w przypadku: androidx.resourceinspection

Wersja 1.3.0-rc01

27 października 2021 roku

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

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

Zmiany w interfejsie API

  • Wymagaj wyjaśnienia w polu „message” w przypadku @Discouraged. (I3390f)
  • Dodanie adnotacji @Discouraged do oznaczania elementów, które są odradzane. (Ib2549)
  • Pokazuj adnotację RestrictTo w wyskakującym okienku dokumentacji Studio (Ie8e1a, b/183134648)

Poprawki błędów

  • Dodaj adnotacje kontekstowe, aby oznaczyć ogólne konteksty, aby deweloperzy mogli łatwiej przejść na nowe interfejsy API. (IE581a)

Wersja 1.3.0-alfa01

24 marca 2021 r.

Aplikacja androidx.annotation:annotation:1.3.0-alpha01 została zwolniona. Wersja 1.3.0-alpha01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Wycofano atrybut @InspectableProperty na rzecz atrybutu @Attribute w wersji androidx.resourceinspection. (Ic0eff)
  • Dodano adnotację @GravityInt do oznaczania elementów zawierających wartości grawitacji ułożone w liczbach całkowitych. (Ifcaa4, b/180620048)

Adnotacja – wersja eksperymentalna 1.4

Wersja 1.4.0

24 stycznia 2024 r.

Aplikacja androidx.annotation:annotation-experimental:1.4.0 została zwolniona. Wersja 1.4.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.3.0

  • Dodaj obsługę wieloplatformowej Kotlin
  • Popraw zgodność z Kotlin 2.0
  • Wyświetlaj ostrzeżenia dotyczące użycia w Javie eksperymentalnych właściwości Kotlin z adnotacjami (I8bd43)
  • Napraw umieszczanie adnotacji autokorekty w metodach Kotlin (Id7a41)

Wersja 1.4.0-rc01

10 stycznia 2024 r.

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

Aplikacja androidx.annotation:annotation-experimental:1.4.0-beta01 została zwolniona. Nie wprowadziliśmy żadnych zmian od poprzedniej wersji.

Wersja 1.4.0-alfa01

29 listopada 2023 r.

Aplikacja androidx.annotation:annotation-experimental:1.4.0-alpha01 została zwolniona. Wersja 1.4.0-alpha01 zawiera te zatwierdzenia.

Poprawki błędów

  • Tymczasowo usuń sugestie autopoprawek na poziomie zajęć, aby obejść problem z b/301598518. (Id98b2).
  • Wyświetlaj ostrzeżenia dotyczące użycia w Javie eksperymentalnych właściwości Kotlin z adnotacjami (I8bd43)
  • Napraw umieszczanie adnotacji autokorekty w metodach Kotlin (Id7a41)

Wersja 1.4.0-dev01

8 lutego 2023 r.

Aplikacja androidx.annotation:annotation-experimental:1.4.0-dev01 została zwolniona. Wersja 1.4.0-dev01 zawiera te zatwierdzenia.

  • Eksperyment dotyczący adnotacji został włączony na wielu platformach w ramach wersji przedpremierowej dla programistów w wersji 1.4.0-dev01 w usłudze Kotlin.

Adnotacja – eksperymentalna wersja 1.3.1

Wersja 1.3.1

21 czerwca 2023 r.

Aplikacja androidx.annotation:annotation-experimental:1.3.1 została zwolniona. Wersja 1.3.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Podczas stosowania autokorekty lintowania umieść adnotację na początku listy modyfikatorów. (b/251172715)
  • Używaj sprawdzania lintowań, aby odradzać używanie 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

Aplikacja androidx.annotation:annotation-experimental:1.3.0 została zwolniona. Wersja 1.3.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.2.0

  • Dodano obsługę użycia @androidx.annotation.OptIn na poziomie pakietu (I24d58)
  • Przeniesiono zależność stdlib Kotlin do typu API, a nie tylko do kompilacji. Oznacza to, że wszyscy klienci biblioteki adnotacji-eksperymentalnej będą w swoich zależnościach przechodnich zawierać standardową bibliotekę Kotlin.

Wersja 1.3.0-rc01

24 sierpnia 2022 r.

Aplikacja androidx.annotation:annotation-experimental:1.3.0-rc01 została zwolniona. Wersja 1.3.0-rc01 zawiera te zatwierdzenia.

  • Brak zmian w stosunku do poprzedniej wersji. Implementacja została wstrzymana w przypadku RC.

Wersja 1.3.0-beta01

10 sierpnia 2022 r.

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

  • Bez zmian w porównaniu z wersją alfa. Ta biblioteka jest ustabilizowana na potrzeby wersji beta.

Wersja 1.3.0-alfa01

27 lipca 2022 roku

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

Zmiany w interfejsie API

  • Dodano obsługę użycia @androidx.annotation.OptIn na poziomie pakietu (I24d58)

Adnotacja – eksperymentalna wersja 1.2.0

Wersja 1.2.0

15 grudnia 2021 roku

Aplikacja 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

Grudzień 1, 2021

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

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

Zmiany w interfejsie API

Interfejsy API zostały udostępnione do wersji beta.

Adnotacja – wersja eksperymentalna 1.2.0-alfa01

30 czerwca 2021 r.

Aplikacja androidx.annotation:annotation-experimental:1.2.0-alpha01 została zwolniona. Wersja 1.2.0-alpha01 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.

Aplikacja 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óra może służyć do identyfikowania metod lub pól używanych do blokowania dostępu na poziomie pakietu SDK i sprawdzania lint NewApi.
  • Dodano adnotację @DoNotInline, która jest powiązana z regułą ProGuard, która uniemożliwia wstawianie członków podczas optymalizacji.
  • Różne adnotacje są teraz opatrzone adnotacją @Documented, aby zapewnić, że będą one wyświetlane w dokumentacji dla wspierających.

Wersja 1.2.0-rc01

24 lutego 2021 r.

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

Aplikacja androidx.annotation:annotation:1.2.0-beta01 została zwolniona. Wersja 1.2.0-beta01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Nowa adnotacja @DoNotInline, która nakazuje optymalizatorom kodu (np. Proguard, R8) niewbudowanie metody z adnotacjami. (I3dfe8, b/141326133)

Wersja 1.2.0-alfa01

14 maja 2020 r.

Aplikacja androidx.annotation:annotation:1.2.0-alpha01 została zwolniona. Wersja 1.2.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodano adnotację @ChecksSdkIntAtLeast. Dzięki temu Androidx i użytkownicy dodają adnotacje do metod i pól reprezentujących kontrolę SDK_INT. (I89a54, b/120255046)

Adnotacja – eksperymentalna wersja 1.1.0

Wersja 1.1.0

7 kwietnia 2021 r.

Aplikacja 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 Jetpack w wersji Kotlin zostały napisane od nowa, aby zapewnić obsługę wielu klas znaczników i ulepszyć obsługę wycofywania aplikacji.
  • Adnotacje RequiresOptIn i OptIn zostały dodane, aby zachować spójność z Kotlin. Adnotacje Experimental i UsesExperimental zostały wycofane.

Wersja 1.1.0-rc02

24 marca 2021 r.

Aplikacja androidx.annotation:annotation-experimental:1.1.0-rc02 została zwolniona. Wersja 1.1.0-rc02 zawiera te zatwierdzenia.

Poprawki błędów

  • Dodano reguły ProGuard, aby mieć pewność, że optymalizacja kodu nie ostrzega o brakujących metaadnotacjach Kotlin.

Wersja 1.1.0-rc01

10 marca 2021 r.

Aplikacja androidx.annotation:annotation-experimental:1.1.0-rc01 została zwolniona. Wersja 1.1.0-rc01 zawiera te zatwierdzenia.

Brak zmian od poprzedniej wersji beta.

Wersja 1.1.0-beta01

27 stycznia 2021 r.

Aplikacja androidx.annotation:annotation-experimental:1.1.0-beta01 została zwolniona. Wersja 1.1.0-beta01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Wariant androidx adnotacji eksperymentalnej został wycofany, aby zapewnić spójność z Kotlinem. Zastąpiła ją wariantem na AndroidaX adnotacji WymagajsOptIn, a linter w języku Java został zaktualizowany, aby obsługiwał zarówno nową adnotację Kotlin, jak i nową wersję Androidax. (I52495, b/151331381)

Wersja 1.1.0-alfa01

22 lipca 2020 r.

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

Nowe funkcje

  • Eksperymentalna biblioteka adnotacji została napisana w Kotlin, ale nie wymaga dodawania biblioteki standardowej Kotlin jako zależności. Zawiera plik Proguard, który umożliwia usunięcie niepotrzebnych metadanych Kotlin z projektów używających wyłącznie języka 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.

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

Główne funkcje wersji 1.0.0

  • Egzekwowanie semantyki Kotlin @Experimental w kodzie źródłowym Javy na podstawie projektu
  • Adnotacje w Javie, które zapewniają zachowanie równoważne z adnotacjami @Experimental i @UseExperimental Kotlin, bez konieczności uzależniania od Kotlin

Adnotacja – wersja eksperymentalna 1.0.0-rc01

23 października 2019 r.

Opublikowano 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

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

Adnotacja – wersja eksperymentalna 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 opublikowane bez zmian od wersji 1.0.0-alpha01. Wersja 1.0.0-beta01 zawiera te zatwierdzenia.

Adnotacja – wersja eksperymentalna 1.0.0-alfa01

18 września 2019 r.

Opublikowano androidx.annotation:annotation-experimental:1.0.0-alpha01 i androidx.annotation:annotation-experimental-lint:1.0.0-alpha01. To są zobowiązania zawarte w adnotacji i eksperymencie 1.0.0-alpha01 oraz zobowiązania zawarte w adnotacji-experimental-lint 1.0.0-alpha01

Nowe funkcje

  • Biblioteka adnotacji Jetpack Experimental zawiera zgodną z Javą implementację eksperymentalnych znaczników interfejsu API firmy Kotlin. Artefakt -lint umożliwia implementację ograniczeń użytkowania w eksperymentach opartych na Lint i egzekwuje ograniczenia dotyczące użycia natywnych, eksperymentalnych znaczników interfejsu API w języku Java.

  • Gdy używasz artefaktu annotation-experimental jako zależności, reguły Lint dostarczane przez ten artefakt annotation-experimental-lint są egzekwowane automatycznie.

Wersja 1.1.0

Wersja 1.1.0

5 czerwca 2019 r.

Wersja androidx.annotation:annotation:1.1.0 została opublikowana bez zmian z wersji 1.1.0-rc01.

Wersja 1.1.0-rc01

7 maja 2019 r.

Opublikowano androidx.annotation:annotation:1.1.0-rc01 bez zmian z 1.1.0-beta01. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Wersja 1.1.0-beta01

3 kwietnia 2019 r.

Aplikacja 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 stosować do metod pobierania w widokach lub innych elementach interfejsu. Narzędzia do generowania kodu mogą za jego pomocą tworzyć obiekty towarzyszące, które mapują nazwy właściwości i przypisują identyfikatory do wartości właściwości bez zbędnego nakładu pracy.

Zmiany w interfejsie API

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

Wersja 1.1.0-alfa02

13 marca 2019 r.

Aplikacja 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 ramach pakietów, których grupy mają ten sam prefiks grupy bibliotek do ostatniego . (kropka). Na przykład biblioteki foo.bar:lib1 i foo.baz:lib2 mają ten sam prefiks foo, dlatego mogą używać własnych interfejsów API, które są ograniczone do tego zakresu. Podobnie w przypadku com.foo.bar:lib1 i com.foo.baz:lib2 prefiks com.foo. może udostępniać interfejsy API ograniczone do tego zakresu. Biblioteka com.bar.qux:lib3 nie będzie jednak mogła korzystać z interfejsu API z ograniczeniami, ponieważ ma ona tylko prefiks com., a nie aż do ostatniego . (kropka).

Wersja 1.1.0-alfa01

30 stycznia 2019 r.

Aplikacja 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 powiększyć. Ta funkcja jest obsługiwana w ComponentActivity w wersji 1.0.0-alpha04 i Fragment w wersji 1.1.0-alpha04 jako alternatywa dla użycia setContentView() lub zastąpienia onCreateView(). (Aosp/837619)

Wersja 1.0.2

Wersja 1.0.2

25 lutego 2019 r.

Aplikacja androidx.annotation:annotation 1.0.2 została zwolniona.

Poprawki błędów

  • Popraw reguły R8/ProGuard, które są osadzone w słoiku. Nieprawidłowe odwoływanie się do starych typów android.support.annotation zamiast androidx.annotation. Uwaga: jeśli nie używasz getDefaultProguardFile, miałoby to wpływ na kompilacje, ponieważ te reguły domyślne zawierały też 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 usuwa adnotacji z typów, zanim zachowa ona jej semantykę. Uwaga: jeśli nie używasz getDefaultProguardFile, miałoby to wpływ na kompilacje, ponieważ te reguły domyślne zawierały też prawidłowe reguły dla obu pakietów. (Aosp/903818)