Аннотация

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

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

Артефакт Стабильный релиз Кандидат на релиз Бета-версия Альфа-релиз
аннотация 1.9.1 - - -
аннотация-экспериментальная 1.5.1 - - -
Последнее обновление этой библиотеки: 16 июля 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 содержит следующие коммиты .

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

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

Версия 1.9.0

16 октября 2024 г.

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

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

  • Добавлена поддержка следующих целей Kotlin Multiplatform: 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-альфа03

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

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

Версия 1.9.0-альфа02

21 августа 2024 г.

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

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

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

Версия 1.9.0-альфа01

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 Multiplatform: 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-альфа02

20 марта 2024 г.

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

Версия 1.8.0-альфа01

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-альфа03

26 июля 2023 г.

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

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

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

Версия 1.7.0-альфа02

24 марта 2023 г.

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

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

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

Версия 1.7.0-альфа01

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 Multiplatform ( 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-альфа01

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 Multiplatform ( 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-альфа02

10 августа 2022 г.

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

  • Никаких изменений с момента предыдущей альфа-версии.

Версия 1.5.0-альфа01

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, помеченные как «открытые», можно аннотировать этой аннотацией, и 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-альфа02

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, помеченные как «открытые», можно аннотировать этой аннотацией, и lint будет гарантировать, что этот класс является подклассом (а методы — только переопределенными) из модульных тестов.

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

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

Версия 1.4.0-альфа01

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-альфа01

24 марта 2021 г.

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

Изменения API

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

Аннотация-Экспериментальная версия 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 stdlib с пустым строковым значением по умолчанию. ( 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-альфа01

21 августа 2024 г.

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

Изменения API

  • Добавьте message в RequiresOptIn для соответствия аннотации Kotlin stdlib с пустым строковым значением по умолчанию. ( 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
  • Показывать предупреждения об использовании Java экспериментально аннотированных свойств Kotlin ( 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-альфа01

29 ноября 2023 г.

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

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

  • Временно удалите предложения по автоисправлению на уровне класса, чтобы обойти ошибку b/301598518 . ( Id98b2 )
  • Показывать предупреждения об использовании Java экспериментально аннотированных свойств Kotlin ( 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 содержит следующие коммиты.

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

  • При применении автоматического исправления lint поместите аннотацию в начало списка модификаторов. ( b/251172715 )
  • Используйте проверку lint, чтобы предотвратить использование 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 stdlib перенесена с типа «только компиляция» на 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-альфа01

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-интерфейсы завершены для бета-тестирования.

Аннотация-Экспериментальная версия 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 и выполнения проверки lint 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-альфа01

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 для обеспечения поддержки нескольких классов маркеров и улучшенной обработки устаревания.
  • Аннотации RequiresOptIn и OptIn были добавлены для соответствия с Kotlin, а аннотации 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

  • Вариант аннотации «Экспериментальная» для Androidx устарел для обеспечения соответствия с Kotlin. Он был заменён вариантом аннотации RequiresOptIn для Androidx, а линтер для Java обновлён для поддержки как новой аннотации Kotlin, так и нового варианта аннотации AndroidX. ( I52495 , b/151331381 )

Версия 1.1.0-альфа01

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

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

Аннотация-Экспериментальная версия 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 предупреждения от детектора использования @Experimental в IDE не отображаются при недопустимом использовании аннотации Kotlin @Experimental в Java. См. b/140640322 .

Аннотация-Экспериментальная версия 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 содержит эти коммиты .

Аннотация-Экспериментальная версия 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 Experimental предоставляет совместимую с Java реализацию экспериментальных маркеров API Kotlin. Артефакт -lint предоставляет реализацию ограничений экспериментального использования на основе Lint и накладывает ограничения на использование собственных экспериментальных маркеров API Kotlin в Java.

  • При использовании артефакта annotation-experimental в качестве зависимости правила Lint, предоставляемые артефактом 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 . Изменения, включённые в эту версию, можно найти здесь .

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

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

Изменения API

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

Версия 1.1.0-альфа02

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-альфа01

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 )