Аннотация

Предоставьте доступ к метаданным, которые помогут инструментам и другим разработчикам понять код вашего приложения.

В этой таблице перечислены все артефакты, входящие в группу androidx.annotation .

Артефакт Стабильный релиз Предварительная версия для выпуска Бета-версия Альфа-версия
аннотация 1.9.1 - - -
аннотация-экспериментальная 1.5.1 - - 1.6.0-alpha01
Последнее обновление этой библиотеки: 22 октября 2025 г.

Объявление зависимостей

Чтобы добавить зависимость от Annotation, необходимо добавить репозиторий Google Maven в ваш проект. Для получения дополнительной информации ознакомьтесь с информацией в репозитории Google Maven .

Добавьте зависимости для необходимых артефактов в файл build.gradle вашего приложения или модуля:

классный 

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

Котлин 

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

Для получения дополнительной информации о зависимостях см. раздел «Добавление зависимостей сборки» .

Обратная связь

Ваши отзывы помогают улучшить Jetpack. Сообщите нам, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете проголосовать за существующую проблему, нажав кнопку со звездочкой.

Создать новую задачу

Для получения более подробной информации см. документацию по системе отслеживания ошибок .

Версия 1.9

Версия 1.9.1

30 октября 2024 г.

Выпущена библиотека androidx.annotation:annotation-*:1.9.1 . Версия 1.9.1 содержит следующие коммиты .

Исправлены ошибки

  • Добавлена ​​целевая платформа JavaScript ( I2310b ).
  • Обновление версии Kotlin до 1.9 ( I1a14c )

Версия 1.9.0

16 октября 2024 г.

Выпущена библиотека androidx.annotation:annotation-*:1.9.0 . Версия 1.9.0 содержит следующие коммиты .

Важные изменения по сравнению с версией 1.8.0

  • Добавлена ​​поддержка следующих многоплатформенных целей Kotlin: watchosDeviceArm64 , mingwX64 , linuxArm64 .

Версия 1.9.0-rc01

2 октября 2024 г.

Выпущена androidx.annotation:annotation-*:1.9.0-rc01 . Версия 1.9.0-rc01 не содержит изменений по сравнению с предыдущей бета-версией.

Версия 1.9.0-beta01

18 сентября 2024 г.

Выпущена библиотека androidx.annotation:annotation-*:1.9.0-beta01 . Версия 1.9.0-beta01 содержит следующие коммиты .

Изменения в API

  • Добавлена ​​поддержка платформы watchosDeviceArm64 ( I1cc04 , b/364652024 )

Версия 1.9.0-alpha03

4 сентября 2024 г.

Выпущена версия androidx.annotation:annotation-*:1.9.0-alpha03 . Версия 1.9.0-alpha03 не содержит изменений по сравнению с предыдущей альфа-версией.

Версия 1.9.0-alpha02

21 августа 2024 г.

Выпущена библиотека androidx.annotation:annotation-*:1.9.0-alpha02 . Версия 1.9.0-alpha02 содержит следующие коммиты .

Новые функции

  • Добавлена ​​поддержка платформы mingwX64 ( I461ca , b/349894318 )
  • Добавлена ​​поддержка многоплатформенной архитектуры Kotlin linuxArm64 . ( I139d3 , b/338268719 )

Версия 1.9.0-alpha01

26 июня 2024 г.

Выпущена библиотека androidx.annotation:annotation-*:1.9.0-alpha01 . Версия 1.9.0-alpha01 содержит следующие коммиты .

Внешний вклад

  • Добавлена ​​поддержка многоплатформенной архитектуры linuxArm64 (спасибо Джейку Уортону!).

Версия 1.8

Версия 1.8.2

7 августа 2024 г.

Выпущена библиотека androidx.annotation:annotation-*:1.8.2 . Версия 1.8.2 содержит следующие коммиты .

Исправлены ошибки

  • Добавлена ​​поддержка платформы mingwX64 ( I461ca , b/349894318 )

Версия 1.8.1

24 июля 2024 г.

Выпущена библиотека androidx.annotation:annotation-*:1.8.1 . Версия 1.8.1 содержит следующие коммиты .

Исправлены ошибки

  • Включает дополнительные многоплатформенные цели Kotlin: watchos , tvos .

Версия 1.8.0

14 мая 2024 г.

Выпущена библиотека androidx.annotation:annotation-*:1.8.0 . Версия 1.8.0 содержит следующие коммиты .

Важные изменения по сравнению с версией 1.7.0

  • Добавлена ​​аннотация @ReplaceWith для выражения замены устаревших API.
  • Аннотация @MainThread перемещена в общий набор исходных файлов.

Версия 1.8.0-rc01

1 мая 2024 г.

Выпущена androidx.annotation:annotation-*:1.8.0-rc01 . Версия 1.8.0-rc01 не содержит изменений по сравнению с предыдущим бета-релизом.

Версия 1.8.0-beta02

17 апреля 2024 г.

Выпущена androidx.annotation:annotation-*:1.8.0-beta02 . Версия 1.8.0-beta02 не содержит изменений по сравнению с предыдущим релизом.

Версия 1.8.0-beta01

3 апреля 2024 г.

Выпущена библиотека androidx.annotation:annotation-*:1.8.0-beta01 . Версия 1.8.0-beta01 содержит следующие коммиты .

Новые функции

  • Аннотация ReplaceWith теперь стабильно работает в API, но соответствующая проверка синтаксиса с автоматическим исправлением пока не реализована.

Версия 1.8.0-alpha02

20 марта 2024 г.

Выпущена androidx.annotation:annotation-*:1.8.0-alpha02 без существенных изменений. Версия 1.8.0-alpha02 содержит следующие коммиты .

Версия 1.8.0-alpha01

21 февраля 2024 г.

Выпущена библиотека androidx.annotation:annotation-*:1.8.0-alpha01 . Версия 1.8.0-alpha01 содержит следующие коммиты.

Изменения в API

  • Добавлена ​​аннотация @ReplaceWith для выражения замен устаревших API. ( I38db3 , b/322373864 )

Внешние вклады

  • Спасибо Ивану Маткову за перенос аннотации @MainThread в общий набор исходных файлов. ( 6f228c )

Версия 1.7

Версия 1.7.1

13 декабря 2023 г.

Выпущена библиотека androidx.annotation:annotation-*:1.7.1 . Версия 1.7.1 содержит следующие коммиты.

Исправлены ошибки

  • Используйте область видимости compile при добавлении зависимости платформы по умолчанию. ( I4958f )

Версия 1.7.0

6 сентября 2023 г.

Выпущена библиотека androidx.annotation:annotation-*:1.7.0 . Версия 1.7.0 содержит следующие коммиты.

Важные изменения по сравнению с версией 1.6.0

  • Включает в себя артефакты Kotlin Multiplatform, ориентированные на платформы iOS, Linux и MacOS.
  • Теперь вы можете использовать аннотации в проектах KMM . Обратите внимание, что целевые платформы аннотаций, отличные от Android, пока находятся в экспериментальной стадии, но мы решили объединить версии, чтобы разработчикам было проще их протестировать. В частности, некоторые аннотации могут перемещаться между общим и платформенно-специфическим кодом во время альфа-тестирования, пока мы уточняем границы возможностей.

Версия 1.7.0-rc01

23 августа 2023 г.

Выпущена библиотека androidx.annotation:annotation-*:1.7.0-rc01 . Версия 1.7.0-rc01 содержит следующие коммиты.

В этом релизе нет никаких изменений по сравнению с предыдущей бета-версией.

Версия 1.7.0-beta01

9 августа 2023 г.

Выпущена библиотека androidx.annotation:annotation-*:1.7.0-beta01 . Версия 1.7.0-beta01 содержит следующие коммиты.

Новые функции

  • Стабилизированные API для выпуска

Версия 1.7.0-alpha03

26 июля 2023 г.

Выпущена библиотека androidx.annotation:annotation-*:1.7.0-alpha03 . Версия 1.7.0-alpha03 содержит следующие коммиты.

Исправлены ошибки

  • В публикации Maven POM теперь в качестве зависимости включается артефакт, ориентированный на JVM и предназначенный для нескольких платформ.

Версия 1.7.0-alpha02

24 марта 2023 г.

Выпущена версия androidx.annotation:annotation-*:1.7.0-alpha02 .

Исправлены ошибки

  • Удалены ограничения зависимостей из артефактов Maven для обхода проблемы сборки в Kotlin Native Targets ( b/274786186 , KT-57531 ).

Версия 1.7.0-alpha01

22 марта 2023 г.

Выпущена библиотека androidx.annotation:annotation-*:1.7.0-alpha01 . Версия 1.7.0-alpha01 содержит следующие коммиты.

Новые функции

  • Включает в себя артефакты Kotlin Multiplatform, ориентированные на платформы iOS, Linux и MacOS.
  • Теперь вы можете использовать аннотации в проектах KMM . Обратите внимание, что целевые платформы аннотаций, отличные от Android, пока находятся в экспериментальной стадии, но мы решили объединить версии, чтобы разработчикам было проще их протестировать. В частности, некоторые аннотации могут перемещаться между общим и платформенно-специфическим кодом во время альфа-тестирования, пока мы уточняем границы возможностей.

Версия 1.6

Версия 1.6.0

22 февраля 2023 г.

Выпущены androidx.annotation:annotation:1.6.0 и androidx.annotation:annotation-jvm:1.6.0 . Версия 1.6.0 содержит следующие коммиты.

Важные изменения с версии 1.5.0

  • Добавляет аннотацию @RequiresExtension указывающую на то, что API требует определённую версию определённого SDK расширения ( I5e4fe ).
  • Библиотека аннотаций преобразована для сборки с использованием многоплатформенного инструментария Kotlin ( I3be8d ).

Версия 1.6.0-rc01

8 февраля 2023 г.

Выпущены androidx.annotation:annotation:1.6.0-rc01 и androidx.annotation:annotation-jvm:1.6.0-rc01 . Версия 1.6.0-rc01 содержит следующие коммиты.

  • Функция аннотирования стабилизирована для предварительной версии 1.6.0-rc01.

Версия 1.6.0-beta01

25 января 2023 г.

Выпущены androidx.annotation:annotation:1.6.0-beta01 и androidx.annotation:annotation-jvm:1.6.0-beta01 без изменений по сравнению с 1.6.0-alpha01 .

Версия 1.6.0-alpha01

11 января 2023 г.

Выпущена библиотека androidx.annotation:annotation-*:1.6.0-alpha01 . Версия 1.6.0-alpha01 содержит следующие коммиты.

Версия 1.6.0-dev01

8 февраля 2023 г.

Выпущена библиотека androidx.annotation:annotation-*:1.6.0-dev01 . Версия 1.6.0-dev01 содержит следующие коммиты.

  • Благодаря аннотациям, Kotlin стал доступен для многоплатформенной разработки в предварительной версии 1.6.0-dev01.

Новые функции

  • Добавляет аннотацию @RequiresExtension указывающую на то, что API требует определённую версию определённого SDK расширения. ( I5e4fe )
  • Библиотека аннотаций преобразована для сборки с использованием многоплатформенного инструментария Kotlin ( I3be8d ).

Версия 1.5.0

Версия 1.5.0

21 сентября 2022 г.

Выпущена версия androidx.annotation:annotation:1.5.0 . Версия 1.5.0 содержит следующие коммиты.

Важные изменения по сравнению с версией 1.4.0

  • Библиотека аннотаций полностью перенесена в исходный код Kotlin, что обеспечивает поддержку целевых сайтов использования, специфичных для Kotlin, и других совместимых с Kotlin функций аннотирования.

Версия 1.5.0-rc01

7 сентября 2022 г.

Выпущена версия androidx.annotation:annotation:1.5.0-rc01 . Версия 1.5.0-rc01 содержит следующие коммиты.

  • Без изменений по сравнению с предыдущей бета-версией 1.5.0.

Версия 1.5.0-beta01

24 августа 2022 г.

Выпущена версия androidx.annotation:annotation:1.5.0-beta01 . Версия 1.5.0-beta01 содержит следующие коммиты.

  • Без изменений по сравнению с предыдущим релизом. API-интерфейс заморожен для бета-тестирования.

Версия 1.5.0-alpha02

10 августа 2022 г.

Выпущена androidx.annotation:annotation:1.5.0-alpha02 . Версия 1.5.0-alpha02 содержит следующие коммиты.

  • С момента предыдущего альфа-релиза изменений не наблюдалось.

Версия 1.5.0-alpha01

27 июля 2022 г.

Выпущена androidx.annotation:annotation:1.5.0-alpha01 . Версия 1.5.0-alpha01 содержит следующие коммиты.

Новые функции

  • Библиотека аннотаций полностью перенесена в исходный код Kotlin, что обеспечивает поддержку целевых сайтов использования, специфичных для Kotlin, и других совместимых с Kotlin функций аннотирования.

Версия 1.4.0

Версия 1.4.0

15 июня 2022 г.

Выпущена версия androidx.annotation:annotation:1.4.0 . Версия 1.4.0 содержит следующие коммиты.

Важные изменения по сравнению с версией 1.3.0

  • @RestrictTo была перенесена в исходный код Kotlin и теперь поддерживает использование @file . В результате библиотека аннотаций теперь зависит от стандартной библиотеки Kotlin.
  • @ReturnThis (b/140249763): Гарантирует, что переопределяющие методы этого метода должны возвращать один и тот же экземпляр (предназначено для построителей и т. д.)
  • @OpenForTesting (b/141539024): Классы и методы Kotlin, помеченные как "open", могут быть аннотированы этой аннотацией, и lint гарантирует, что этот класс будет наследоваться (а методы переопределены только) только из модульных тестов.
  • @DeprecatedSinceApi (b/37116481): Указывает, что аннотированный метод (или класс, или поле) является частью библиотеки бэкпорта для API платформы, которая больше не требуется на данном уровне API.
  • @EmptySuper : Указывает, что этот метод определен как пустой, поэтому при переопределении вам не нужно его вызывать (и на самом деле не следует этого делать; например, он может содержать проверку обратной совместимости).

Версия 1.4.0-rc01

1 июня 2022 г.

Выпущена версия androidx.annotation:annotation:1.4.0-rc01 . Версия 1.4.0-rc01 содержит следующие коммиты.

  • Интерфейс и функциональность API окончательно доработаны и готовы к выпуску.

Версия 1.4.0-beta01

18 мая 2022 г.

Выпущена версия androidx.annotation:annotation:1.4.0-beta01 . Версия 1.4.0-beta01 содержит следующие коммиты.

  • С момента выхода последней альфа-версии изменений нет. Доступ к API заблокирован для бета-версии.

Версия 1.4.0-alpha02

9 февраля 2022 г.

Выпущена androidx.annotation:annotation:1.4.0-alpha02 . Версия 1.4.0-alpha02 содержит следующие коммиты.

Новые функции

  • Добавлены аннотации @ReturnThis , @OpenForTesting , @EmptySuper и @DeprecatedSinceApi . ( 21946a2 )

  • @ReturnThis ( b/140249763 ): Гарантирует, что переопределяющие методы этого метода должны возвращать один и тот же экземпляр (предназначено для построителей и т. д.)

  • @OpenForTesting ( b/141539024 ): Классы и методы Kotlin, помеченные как "open", могут быть аннотированы этой аннотацией, и линтер гарантирует, что этот класс будет наследоваться (и методы будут переопределены) только из модульных тестов.

  • @DeprecatedSinceApi ( b/37116481 ): Указывает, что аннотированный метод (или класс, или поле) является частью библиотеки бэкпорта для API платформы, которая больше не требуется на данном уровне API.

  • @EmptySuper : Указывает, что этот метод определен как пустой, поэтому при переопределении вам не нужно его вызывать (и на самом деле не следует этого делать; например, он может содержать проверку обратной совместимости).

Версия 1.4.0-alpha01

15 декабря 2021 г.

Выпущена androidx.annotation:annotation:1.4.0-alpha01 . Версия 1.4.0-alpha01 содержит следующие коммиты.

Изменения в API

  • Перенесена аннотация RestrictTo в исходный код Kotlin ( Ia6336 )

Версия 1.3.0

Версия 1.3.0

3 ноября 2021 г.

Выпущена версия androidx.annotation:annotation:1.3.0 . Версия 1.3.0 содержит следующие коммиты.

Важные изменения по сравнению с версией 1.2.0

  • Аннотация @Discouraged используется для обозначения API, которые нельзя обоснованно объявить устаревшими, но которые оказывают существенное негативное влияние на производительность и не должны вызываться в обычном рабочем коде.
  • Аннотация @Context используется для обозначения универсальных контекстов, что упрощает разработчикам переход на новые API.
  • Аннотация @GravityInt для маркировки элементов, содержащих значения гравитации, упакованные в целые числа.
  • Устаревшая аннотация @InspectableProperty заменена на @Attribute для androidx.resourceinspection

Версия 1.3.0-rc01

27 октября 2021 г.

Выпущена версия androidx.annotation:annotation:1.3.0-rc01 . Версия 1.3.0-rc01 содержит следующие коммиты.

Версия 1.3.0-beta01

29 сентября 2021 г.

Выпущена версия androidx.annotation:annotation:1.3.0-beta01 . Версия 1.3.0-beta01 содержит следующие коммиты.

Изменения в API

  • Требуется пояснение в сообщении для @Discouraged. ( I3390f )
  • Добавление аннотации @Discouraged для пометки элементов, которые не рекомендуются к использованию. ( Ib2549 )
  • Сделайте аннотацию RestrictTo видимой во всплывающем окне документации Studio ( Ie8e1a , b/183134648 )

Исправлены ошибки

  • Добавить аннотацию Context для обозначения универсальных контекстов, чтобы разработчикам было проще переходить на новые API. ( IE581a )

Версия 1.3.0-alpha01

24 марта 2021 г.

Выпущена версия androidx.annotation:annotation:1.3.0-alpha01 . Версия 1.3.0-alpha01 содержит следующие коммиты.

Изменения в API

  • В androidx.resourceinspection аннотация @InspectableProperty устарела, вместо неё используется @Attribute . ( Ic0eff )
  • Добавлена ​​аннотация @GravityInt для маркировки элементов, содержащих значения гравитации, упакованные в целые числа. ( Ifcaa4 , b/180620048 )

Аннотации — экспериментальная версия 1.6

Версия 1.6.0-alpha01

22 октября 2025 г.

Выпущена версия androidx.annotation:annotation-experimental:1.6.0-alpha01 . Версия 1.6.0-alpha01 содержит следующие коммиты .

Изменения в API

  • Аннотация OptIn теперь поддерживает целевой объект ElementType.PARAMETER .

Аннотации — экспериментальная версия 1.5

Версия 1.5.1

16 июля 2025 г.

Выпущена версия androidx.annotation:annotation-experimental:1.5.1 . Версия 1.5.1 содержит следующие коммиты .

Версия 1.5.0

7 мая 2025 г.

Выпущена версия androidx.annotation:annotation-experimental:1.5.0 . Версия 1.5.0 содержит следующие коммиты .

Важные изменения по сравнению с версией 1.4.0

  • Добавлено message к RequiresOptIn для сопоставления аннотации стандартной библиотеки Kotlin со значением пустой строки по умолчанию. ( I1f50e )
  • Эта библиотека теперь ориентирована на язык Kotlin 2.0 и требует KGP 2.0.0 или более поздней версии. ( Idb6b5 )

Версия 1.5.0-rc01

23 апреля 2025 г.

Выпущена androidx.annotation:annotation-experimental:1.5.0-rc01 . Версия 1.5.0-rc01 не содержит изменений по сравнению с предыдущим бета-релизом, см. коммиты .

Версия 1.5.0-beta01

9 апреля 2025 г.

Выпущена версия androidx.annotation:annotation-experimental:1.5.0-beta01 . Версия 1.5.0-beta01 содержит следующие коммиты .

Важные изменения

  • В настоящее время эта библиотека ориентирована на язык Kotlin 2.0 и требует KGP 2.0.0 или более новой версии ( Idb6b5 ).

Версия 1.5.0-alpha01

21 августа 2024 г.

Выпущена версия androidx.annotation:annotation-experimental:1.5.0-alpha01 . Версия 1.5.0-alpha01 содержит следующие коммиты .

Изменения в API

  • Добавить message в RequiresOptIn , чтобы оно соответствовало аннотации стандартной библиотеки Kotlin со значением пустой строки по умолчанию. ( I1f50e )

Аннотации — экспериментальная версия 1.4

Версия 1.4.1

3 апреля 2024 г.

Выпущена версия androidx.annotation:annotation-experimental:1.4.1 . Версия 1.4.1 содержит следующие коммиты .

Исправлены ошибки

  • Исправлено использование isKotlin , чтобы избежать случайного срабатывания проверки RequiresOptIn в файлах Kotlin. ( I2d8c1f )

Версия 1.4.0

24 января 2024 г.

Выпущена версия androidx.annotation:annotation-experimental:1.4.0 . Версия 1.4.0 содержит следующие коммиты.

Важные изменения по сравнению с версией 1.3.0

  • Добавлена ​​поддержка многоплатформенной разработки Kotlin.
  • Исправлена ​​совместимость с Kotlin 2.0
  • Показать предупреждения об использовании экспериментально аннотированных свойств Kotlin в Java ( I8bd43 )
  • Исправлено размещение аннотации autofix на методах Kotlin ( Id7a41 )

Версия 1.4.0-rc01

10 января 2024 г.

Выпущена androidx.annotation:annotation-experimental:1.4.0-rc01 . Версия 1.4.0-rc01 не содержит изменений по сравнению с предыдущим релизом.

Версия 1.4.0-beta01

13 декабря 2023 г.

Выпущена версия androidx.annotation:annotation-experimental:1.4.0-beta01 . Изменений по сравнению с предыдущим релизом нет.

Версия 1.4.0-alpha01

29 ноября 2023 г.

Выпущена версия androidx.annotation:annotation-experimental:1.4.0-alpha01 . Версия 1.4.0-alpha01 содержит следующие коммиты.

Исправлены ошибки

  • Временно удалены предложения по автоматическому исправлению на уровне класса для обхода ошибки b/301598518 . ( Id98b2 )
  • Показать предупреждения об использовании экспериментально аннотированных свойств Kotlin в Java ( I8bd43 )
  • Исправлено размещение аннотации autofix на методах Kotlin ( Id7a41 )

Версия 1.4.0-dev01

8 февраля 2023 г.

Выпущена версия androidx.annotation:annotation-experimental:1.4.0-dev01 . Версия 1.4.0-dev01 содержит следующие коммиты.

  • Annotation-experimental обеспечил поддержку многоплатформенности Kotlin для предварительной версии 1.4.0-dev01 для разработчиков.

Аннотации — экспериментальная версия 1.3.1

Версия 1.3.1

21 июня 2023 г.

Выпущена версия androidx.annotation:annotation-experimental:1.3.1 . Версия 1.3.1 содержит следующие коммиты.

Исправлены ошибки

  • При применении автоматического исправления ошибок линтинга добавьте аннотацию в начало списка модификаторов. ( b/251172715 )
  • Используйте проверку синтаксиса, чтобы отговорить от использования androidx.annotation.RequiresOptIn в исходном коде Kotlin ( b/241097743 )

Аннотации — экспериментальная версия 1.3.0

Версия 1.3.0

7 сентября 2022 г.

Выпущена версия androidx.annotation:annotation-experimental:1.3.0 . Версия 1.3.0 содержит следующие коммиты.

Важные изменения по сравнению с версией 1.2.0

  • Добавлена ​​поддержка использования @androidx.annotation.OptIn на уровне пакета ( I24d58 )
  • Зависимость от стандартной библиотеки Kotlin перенесена из разряда "только компиляция" в разряд зависимостей API. Это означает, что все клиенты библиотеки Annotation-Experimental будут включать стандартную библиотеку Kotlin в свои транзитивные зависимости.

Версия 1.3.0-rc01

24 августа 2022 г.

Выпущена версия androidx.annotation:annotation-experimental:1.3.0-rc01 . Версия 1.3.0-rc01 содержит следующие коммиты.

  • Без изменений по сравнению с предыдущим релизом. Реализация приостановлена ​​для выпуска RC.

Версия 1.3.0-beta01

10 августа 2022 г.

Выпущена версия androidx.annotation:annotation-experimental:1.3.0-beta01 . Версия 1.3.0-beta01 содержит следующие коммиты.

  • Без изменений по сравнению с альфа-версией. Эта библиотека стабилизирована для бета-версии.

Версия 1.3.0-alpha01

27 июля 2022 г.

Выпущена версия androidx.annotation:annotation-experimental:1.3.0-alpha01 . Версия 1.3.0-alpha01 содержит следующие коммиты.

Изменения в API

  • Добавлена ​​поддержка использования @androidx.annotation.OptIn на уровне пакета ( I24d58 )

Аннотации — экспериментальная версия 1.2.0

Версия 1.2.0

15 декабря 2021 г.

Выпущена версия androidx.annotation:annotation-experimental:1.2.0 . Версия 1.2.0 содержит следующие коммиты.

Важные изменения по сравнению с версией 1.1.0

В настоящее время эта библиотека ориентирована на язык Java 8.

Версия 1.2.0-rc01

1 декабря 2021 г.

Выпущена версия androidx.annotation:annotation-experimental:1.2.0-rc01 . Версия 1.2.0-rc01 содержит следующие коммиты.

Изменений по сравнению с бета-версией нет.

Версия 1.2.0-beta01

17 ноября 2021 г.

Выпущена версия androidx.annotation:annotation-experimental:1.2.0-beta01 . Версия 1.2.0-beta01 содержит следующие коммиты.

Изменения в API

API-интерфейсы доработаны для бета-тестирования.

Annotation-Experimental Version 1.2.0-alpha01

30 июня 2021 г.

Выпущена версия androidx.annotation:annotation-experimental:1.2.0-alpha01 . Версия 1.2.0-alpha01 содержит следующие коммиты.

Новые функции

  • Теперь библиотека ориентирована на язык Java 8.

Версия 1.2.0

Версия 1.2.0

24 марта 2021 г.

Выпущена версия androidx.annotation:annotation:1.2.0 . Версия 1.2.0 содержит следующие коммиты.

Значительные изменения по сравнению с версией 1.1.0

  • Добавлена ​​аннотация @ChecksSdkIntAtLeast , которую можно использовать для идентификации методов или полей, ограничивающих доступ на уровне SDK и удовлетворяющих проверке синтаксиса NewApi .
  • Добавлена ​​аннотация @DoNotInline , которая используется в паре с правилом Proguard для предотвращения встраивания элементов во время оптимизации.
  • Теперь различные аннотации помечаются аннотацией @Documented , чтобы гарантировать их отображение в документации для аннотированных участников.

Версия 1.2.0-rc01

24 февраля 2021 г.

Выпущена версия androidx.annotation:annotation:1.2.0-rc01 . Версия 1.2.0-rc01 содержит следующие коммиты.

Версия 1.2.0-beta01

13 января 2021 г.

Выпущена версия androidx.annotation:annotation:1.2.0-beta01 . Версия 1.2.0-beta01 содержит следующие коммиты.

Изменения в API

  • Новая аннотация @DoNotInline , которая указывает оптимизаторам кода (например, Proguard, R8) не встраивать аннотированный метод. ( I3dfe8 , b/141326133 )

Версия 1.2.0-alpha01

14 мая 2020 г.

Выпущена версия androidx.annotation:annotation:1.2.0-alpha01 . Версия 1.2.0-alpha01 содержит следующие коммиты.

Новые функции

  • Добавлена ​​аннотация @ChecksSdkIntAtLeast . Это позволяет androidx и пользователям аннотировать методы и поля, представляющие проверку SDK_INT . ( I89a54 , b/120255046 )

Аннотации — экспериментальная версия 1.1.0

Версия 1.1.0

7 апреля 2021 г.

Выпущена версия androidx.annotation:annotation-experimental:1.1.0 . Версия 1.1.0 содержит следующие коммиты.

Значительные изменения с версии 1.0.0

  • Экспериментальные аннотации Jetpack были переписаны на Kotlin для обеспечения поддержки нескольких классов маркеров и улучшенной обработки устаревших функций.
  • Для обеспечения совместимости с Kotlin добавлены аннотации RequiresOptIn и OptIn , а аннотации Experimental и UsesExperimental устарели.

Версия 1.1.0-rc02

24 марта 2021 г.

Выпущена версия androidx.annotation:annotation-experimental:1.1.0-rc02 . Версия 1.1.0-rc02 содержит следующие коммиты.

Исправлены ошибки

  • Добавлены правила Proguard, гарантирующие, что оптимизация кода не будет выдавать предупреждения об отсутствующих мета-аннотациях Kotlin.

Версия 1.1.0-rc01

10 марта 2021 г.

Выпущена версия androidx.annotation:annotation-experimental:1.1.0-rc01 . Версия 1.1.0-rc01 содержит следующие коммиты.

С момента предыдущего бета-релиза изменений не наблюдалось.

Версия 1.1.0-beta01

27 января 2021 г.

Выпущена версия androidx.annotation:annotation-experimental:1.1.0-beta01 . Версия 1.1.0-beta01 содержит следующие коммиты.

Изменения в API

  • Вариант аннотации Experimental с префиксом androidx был объявлен устаревшим для обеспечения совместимости с Kotlin. Он был заменен вариантом аннотации RequiresOptIn с префиксом androidx, а Java-линтер был обновлен для поддержки как новой аннотации Kotlin, так и нового варианта androidx. ( I52495 , b/151331381 )

Версия 1.1.0-alpha01

22 июля 2020 г.

Выпущена версия androidx.annotation:annotation-experimental:1.1.0-alpha01 . Версия 1.1.0-alpha01 содержит следующие коммиты.

Новые функции

  • Экспериментальная библиотека аннотаций теперь написана на Kotlin, но не требует включения стандартной библиотеки Kotlin в качестве зависимости. Она включает файл Proguard, который позволяет удалять ненужные метаданные Kotlin из проектов, использующих только язык программирования Java.
  • @UseExperimental теперь поддерживает несколько классов маркеров ( aosp/1185577 , b/145137892 )

Аннотации — экспериментальная версия 1.0.0

Аннотации — экспериментальная версия 1.0.0

7 ноября 2019 г.

androidx.annotation:annotation-experimental:1.0.0 и androidx.annotation:annotation-experimental-lint:1.0.0 выпущены без изменений по сравнению с 1.0.0-rc01 . Версия 1.0.0 содержит следующие коммиты .

Основные особенности версии 1.0.0

  • Проверка соответствия семантике Kotlin @Experimental в исходном коде Java с помощью линтера
  • Аннотации Java, обеспечивающие поведение, эквивалентное аннотациям @Experimental и @UseExperimental в Kotlin, без необходимости зависимости от Kotlin.

Annotation-Experimental Version 1.0.0-rc01

23 октября 2019 г.

Выпущены androidx.annotation:annotation-experimental:1.0.0-rc01 и androidx.annotation:annotation-experimental-lint:1.0.0-rc01 . Версия 1.0.0-rc01 содержит следующие коммиты .

Известные проблемы

При использовании Studio 3.5 stable предупреждения от детектора ошибок использования @Experimental не отображаются в IDE для некорректного использования аннотации Kotlin @Experimental в Java. См. b/140640322 .

Annotation-Experimental Version 1.0.0-beta01

9 октября 2019 г.

androidx.annotation:annotation-experimental:1.0.0-beta01 и androidx.annotation:annotation-experimental-lint:1.0.0-beta01 выпущены без изменений по сравнению с версией 1.0.0-alpha01 . Версия 1.0.0-beta01 содержит следующие коммиты .

Annotation-Experimental Version 1.0.0-alpha01

18 сентября 2019 г.

Выпущены androidx.annotation:annotation-experimental:1.0.0-alpha01 и androidx.annotation:annotation-experimental-lint:1.0.0-alpha01 . Вот коммиты, включенные в annotation-experimental 1.0.0-alpha01 , и вот коммиты, включенные в annotation-experimental-lint 1.0.0-alpha01

Новые функции

  • Библиотека экспериментальных аннотаций Jetpack предоставляет Java-совместимую реализацию экспериментальных маркеров API Kotlin. Артефакт -lint предоставляет реализацию ограничений на использование экспериментальных маркеров на основе Lint и обеспечивает соблюдение ограничений на использование собственных экспериментальных маркеров API Kotlin в Java.

  • При использовании артефакта annotation-experimental annotation-experimental-lint будут применяться автоматически.

Версия 1.1.0

Версия 1.1.0

5 июня 2019 г.

Выпущена версия androidx.annotation:annotation:1.1.0 без изменений по сравнению с версией 1.1.0-rc01.

Версия 1.1.0-rc01

7 мая 2019 г.

Выпущена версия androidx.annotation:annotation:1.1.0-rc01 без изменений по сравнению с версией 1.1.0-beta01 . Список изменений, включенных в эту версию, можно найти здесь .

Версия 1.1.0-beta01

3 апреля 2019 г.

Выпущена версия androidx.annotation:annotation:1.1.0-beta01 . Список изменений, включенных в эту версию, можно найти здесь .

Новые функции

  • В Android 10 добавлена ​​новая аннотация @InspectableProperty для поддержки новых API проверки представлений. Эту аннотацию можно применять к геттерам представлений или других элементов пользовательского интерфейса. Инструменты генерации кода могут использовать её для создания вспомогательных объектов, которые сопоставляют имена свойств и идентификаторы атрибутов со значениями свойств без дополнительных затрат на рефлексию.

изменения API

  • Критическое изменение: аннотация @ContentView была заменена на аннотацию конструктора, а значение @LayoutRes было удалено. Классы, желающие поддерживать аннотации @ContentView , должны добавлять эту аннотацию к конструктору, принимающему @LayoutRes int . Это исправляет проблему при использовании этой аннотации в модулях библиотек. ( b/128352521 )

Версия 1.1.0-alpha02

13 марта 2019 г.

Выпущена версия androidx.annotation:annotation:1.1.0-alpha02 . Полный список изменений, включенных в эту версию, можно найти здесь .

Новые функции

  • Новая область ограничения API: RestrictTo.Scope.LIBRARY_GROUP_PREFIX . Она ограничивает использование кода в пакетах, группы которых имеют одинаковый префикс группы библиотек до последней точки . Например, поскольку библиотеки foo.bar:lib1 и foo.baz:lib2 имеют общий префикс foo , они могут использовать API друг друга, ограниченные этой областью. Аналогично, для com.foo.bar:lib1 и com.foo.baz:lib2 , имеющих общий префикс com.foo. , доступны API, ограниченные этой областью. Однако библиотека com.bar.qux:lib3 не сможет использовать ограниченный API, поскольку она имеет общий префикс только com. а не до последней точки .

Версия 1.1.0-alpha01

30 января 2019 г.

Выпущена аннотация androidx.annotation:annotation 1.1.0-alpha01 .

Новые функции

  • Добавлена ​​аннотация @ContentView , позволяющая указать, какой XML-файл макета следует загрузить. Эта функция поддерживается в ComponentActivity в версии 1.0.0-alpha04 и Fragment в версии 1.1.0-alpha04 в качестве альтернативы использованию setContentView() или переопределению onCreateView() соответственно. ( aosp/837619 )

Версия 1.0.2

Версия 1.0.2

25 февраля 2019 г.

Выпущена версия androidx.annotation:annotation 1.0.2 .

Исправлены ошибки

  • Исправьте правила R8/ProGuard, встроенные в jar-файл. Они некорректно ссылались на старые типы android.support.annotation вместо androidx.annotation . Примечание: это повлияло бы на ваши сборки только в том случае, если бы вы не использовали getDefaultProguardFile поскольку эти правила по умолчанию также включали правильные правила для обоих пакетов. ( aosp/891685 )
  • Добавьте правило R8/ProGuard, которое явно сохраняет саму аннотацию @Keep. Это гарантирует, что ProGuard не удалит аннотацию из типов до того, как они начнут учитывать их семантику. Примечание: это повлияло бы на ваши сборки только в том случае, если бы вы не использовали getDefaultProguardFile поскольку эти правила по умолчанию также включали корректные правила для обоих пакетов. ( aosp/903818 )