Аннотация

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

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

Артефакт Стабильный выпуск Кандидат на выпуск Бета-версия Альфа-релиз
аннотация 1.8.2 - 1.9.0-бета01 -
аннотация-экспериментальная 1.4.1 - - 1.5.0-альфа01
Последнее обновление этой библиотеки: 18 сентября 2024 г.

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

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

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

Groovy

dependencies {
    implementation "androidx.annotation:annotation:1.9.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.9.0")
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation("androidx.annotation:annotation-experimental:1.4.1")
}

Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .

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

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

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

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

Версия 1.9

Версия 1.9.0-бета01

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 , б/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: 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-бета02

17 апреля 2024 г.

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

Версия 1.8.0-бета01

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 , б/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, предназначенные для платформ 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-бета01

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, предназначенные для платформ 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-бета01

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 ( 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-бета01

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-бета01

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-бета01

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

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

Изменения API

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

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

  • Добавьте аннотацию контекста, чтобы отметить общие контексты, чтобы разработчикам было проще перейти на новые 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 , б/180620048 )

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

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

21 августа 2024 г.

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

Изменения API

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

Версия 1.4.0-rc01

10 января 2024 г.

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

Версия 1.4.0-бета01

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 ).
  • Исправлено размещение аннотации автоисправления в методах 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 содержит эти коммиты.

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

  • Размещайте аннотацию в начале списка модификаторов при применении автоматического исправления ворса. ( б/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 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-бета01

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-бета01

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 и выполнения проверки проверки NewApi .
  • Добавлена ​​аннотация @DoNotInline , которая в сочетании с правилом Proguard предотвращает встраивание элементов во время оптимизации.
  • Различные аннотации теперь помечаются @Documented , чтобы они отображались в документации для аннотированных членов.

Версия 1.2.0-rc01

24 февраля 2021 г.

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

Версия 1.2.0-бета01

13 января 2021 г.

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

Изменения API

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

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

14 мая 2020 г.

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

Новые возможности

  • Добавлена ​​аннотация @ChecksSdkIntAtLeast . Это позволит androidx и пользователям аннотировать методы и поля, которые представляют собой проверку SDK_INT . ( I89a54 , б/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-бета01

27 января 2021 г.

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

Изменения API

  • Вариант экспериментальной аннотации androidx устарел, чтобы обеспечить равенство с Kotlin. Он был заменен вариантом аннотации RequiresOptIn для Androidx, а линтер, ориентированный на Java, был обновлен для поддержки как новой аннотации Kotlin, так и нового варианта androidx. ( I52495 , б / 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 на основе Lint в исходном коде Java
  • Аннотации Java, которые обеспечивают поведение, эквивалентное аннотациям @Experimental и @UseExperimental Kotlin, без необходимости зависимости от 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 о недопустимом использовании Java аннотации Kotlin @Experimental . См. 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 и налагает ограничения на использование Java собственных экспериментальных маркеров API Kotlin.

  • При использовании артефакта 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-бета01

3 апреля 2019 г.

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

Новые возможности

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

Изменения API

  • Критическое изменение: @ContentView был изменен на аннотацию конструктора, а значение @LayoutRes было удалено. Классы, желающие поддерживать аннотации @ContentView должны добавить эту аннотацию в конструктор, который принимает параметр @LayoutRes int . Это устраняет проблему при использовании этой аннотации в модулях библиотеки. ( б / 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() соответственно. ( аосп/837619 )

Версия 1.0.2

Версия 1.0.2

25 февраля 2019 г.

androidx.annotation:annotation 1.0.2 .

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

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

Аннотация

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

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

Артефакт Стабильный выпуск Кандидат на выпуск Бета-версия Альфа-релиз
аннотация 1.8.2 - 1.9.0-бета01 -
аннотация-экспериментальная 1.4.1 - - 1.5.0-альфа01
Последнее обновление этой библиотеки: 18 сентября 2024 г.

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

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

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

Groovy

dependencies {
    implementation "androidx.annotation:annotation:1.9.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.9.0")
    // To use the Java-compatible @androidx.annotation.OptIn API annotation
    implementation("androidx.annotation:annotation-experimental:1.4.1")
}

Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .

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

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

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

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

Версия 1.9

Версия 1.9.0-бета01

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 , б/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: 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-бета02

17 апреля 2024 г.

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

Версия 1.8.0-бета01

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 , б/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, предназначенные для платформ 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-бета01

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, предназначенные для платформ 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-бета01

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 ( 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-бета01

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-бета01

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, отмеченные «открытым»

  • @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 Annotation для маркировки 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-бета01

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

androidx.annotation:annotation:1.3.0-beta01 выпускается. Версия 1.3.0-бета01 содержит эти коммиты.

API меняется

  • Требовать объяснения в «Сообщении» для @Discouraged. ( I3390f )
  • Добавление @Discouraged Annotation для маркировки элементов, которые обескуражены. ( IB2549 )
  • Сделайте ограничение аннотации видимым от всплывающего окна студийных документов ( IE8E1A , B/183134648 )

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

  • Добавьте контекстные аннотации, чтобы отметить общие контексты, чтобы разработчики могли легче мигрировать на новые API. ( IE581A )

Версия 1.3.0-Alpha01

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.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-бета01

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 содержит эти коммиты.

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

  • Временно удалить предложения AutoFix на уровне класса, чтобы работать вокруг 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 Multi-Platform для предварительного просмотра разработчиков 1.4.0-DEV01.

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

Версия 1.3.1

21 июня 2023 г.

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

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

  • Поместите аннотацию в начале списка модификаторов при применении Lint Auto-Fix. ( 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 )
  • Перенесена зависимость от stdlib kotlin в AP-тип, а не только для компиляции. Это означает, что все клиенты аннотационной экспериментальной библиотеки будут включать в себя стандартную библиотеку Kotlin в их переходных зависимостях.

Версия 1.3.0-RC01

24 августа 2022 г.

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

  • Нет изменений от предыдущего релиза. Реализация была заморожена для RC.

Версия 1.3.0-бета01

10 августа 2022 г.

androidx.annotation:annotation-experimental:1.3.0-beta01 выпускается. Версия 1.3.0-бета01 содержит эти коммиты.

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

Версия 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-бета01

17 ноября 2021 года

androidx.annotation:annotation-experimental:1.2.0-beta01 выпускается. Версия 1.2.0-бета01 содержит эти коммиты.

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 Annotation, которая может использоваться для идентификации методов или полей, используемых для затвора на уровне SDK, и удовлетворения чека NewApi Lint.
  • Добавлена ​​аннотация @DoNotInline , которая в сочетании с правилом прогноза, чтобы предотвратить подставку участников во время оптимизации.
  • Разнообразные аннотации теперь аннотируются с @Documented чтобы убедиться, что они появляются в документации для аннотированных участников.

Версия 1.2.0-RC01

24 февраля 2021 г.

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

Версия 1.2.0-бета01

13 января 2021 года

androidx.annotation:annotation:1.2.0-beta01 выпускается. Версия 1.2.0-бета01 содержит эти коммиты.

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 Annotation. Это Let's 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 были переписаны в Котлине, чтобы обеспечить поддержку множественного маркера и улучшения обработки детективы.
  • RequiresOptIn аннотации OptIn были добавлены для паритета с Kotlin, а Experimental и UsesExperimental аннотации были вынуждены.

Версия 1.1.0-RC02

24 марта 2021 г.

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

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

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

Версия 1.1.0-RC01

10 марта 2021 г.

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

Нет изменений с момента предварительного бета -выпуска.

Версия 1.1.0-бета01

27 января 2021 года

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

API меняется

  • Вариант Androidx экспериментальной аннотации был устарел для обеспечения паритета с котлином. Он был заменен вариантом Androidx аннотации TranyOptin, а Linter, обращенный на Java, был обновлен для поддержки как новой аннотации Kotlin, так и нового варианта Androidx. ( I52495 , B/151331381 )

Версия 1.1.0-Alpha01

22 июля 2020 г.

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

Новые возможности

  • Экспериментальная библиотека аннотаций в настоящее время написана в Котлин, но не требует, чтобы стандартная библиотека Котлина была включена в качестве зависимости. Он включает в себя файл прогноза, который позволяет измерять ненужные метаданные котлина из проектов, которые используют только язык программирования 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 Semantics в исходном коде Java на основе пронзака в исходном коде Java
  • Аннотации Java, которые обеспечивают эквивалентное поведение для @Experimental и @UseExperimental Annotations без необходимости зависимости от котлин

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

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

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 выпускаются. Это коммиты, включенные в аннотацию-экспериментальную 1.0.0-alpha01 , и это коммиты, включенные в аннотацию-экспериментальную линту 1.0.0-alpha01

Новые возможности

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

  • При использовании 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-бета01

3 апреля 2019 г.

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

Новые возможности

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

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, которые встроены в банку. Это неправильно ссылались на старые типы android.support.annotation вместо androidx.annotation . Примечание. Это оказало бы влияние на ваши сборки, только если бы вы не использовали getDefaultProguardFile , поскольку эти правила по умолчанию также включали правильные правила для обоих пакетов. ( AOSP/891685 )
  • Добавьте правило R8/Proguard, которое явно сохраняет саму аннотацию @keep. Это гарантирует, что Proguard не удаляет аннотацию из типов до фактической чести его семантики. Примечание. Это оказало бы влияние на ваши сборки, только если бы вы не использовали getDefaultProguardFile , поскольку эти правила по умолчанию также включали правильные правила для обоих пакетов. ( AOSP/903818 )