Anotación

  
Expón los metadatos que ayudan a las herramientas y a otros desarrolladores a comprender el código de tu app.

En esta tabla, se incluyen todos los artefactos del grupo androidx.annotation.

Artefacto Versión estable Versión potencial Versión beta Versión alfa
anotación 1.8.2 - - 1.9.0-alpha03
annotation-experimental 1.4.1 - - 1.5.0-alpha01
Esta biblioteca se actualizó por última vez el 4 de septiembre de 2024

Cómo declarar dependencias

Para agregar una dependencia en Annotation, debes agregar el repositorio de Maven de Google a tu proyecto. Consulta el repositorio de Maven de Google para obtener más información.

Agrega las dependencias de los artefactos que necesites en el archivo build.gradle de tu app o módulo:

Groovy

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

Para obtener más información sobre las dependencias, consulta Cómo agregar dependencias de compilación.

Comentarios

Tus comentarios ayudan a mejorar Jetpack. Avísanos si descubres nuevos errores o tienes ideas para mejorar esta biblioteca. Consulta los errores existentes de esta biblioteca antes de crear uno nuevo. Puedes agregar tu voto a un error existente haciendo clic en el botón de la estrella.

Crear un error nuevo

Consulta la documentación sobre la Herramienta de seguimiento de errores para obtener más información.

Versión 1.9

Versión 1.9.0-alpha03

4 de septiembre de 2024

Lanzamiento de androidx.annotation:annotation-*:1.9.0-alpha03. La versión 1.9.0-alpha03 no contiene cambios desde la versión alfa anterior.

Versión 1.9.0-alpha02

21 de agosto de 2024

Lanzamiento de androidx.annotation:annotation-*:1.9.0-alpha02. La versión 1.9.0-alpha02 contiene estas confirmaciones.

Nuevas funciones

  • Se agregó compatibilidad con la plataforma mingwX64 (I461ca, b/349894318).
  • Se agregó compatibilidad con el objetivo multiplataforma de Kotlin linuxArm64. (I139d3, b/338268719).

Versión 1.9.0-alpha01

26 de junio de 2024

Lanzamiento de androidx.annotation:annotation-*:1.9.0-alpha01. La versión 1.9.0-alpha01 contiene estas confirmaciones.

Contribución externa

  • Se agregó compatibilidad con el destino multiplataforma linuxArm64 (gracias a Jake Wharton).

Versión 1.8

Versión 1.8.2

7 de agosto de 2024

Lanzamiento de androidx.annotation:annotation-*:1.8.2. La versión 1.8.2 contiene estas confirmaciones.

Correcciones de errores

Versión 1.8.1

24 de julio de 2024

Lanzamiento de androidx.annotation:annotation-*:1.8.1. La versión 1.8.1 contiene estas confirmaciones.

Correcciones de errores

  • Incluye objetivos multiplataforma adicionales de Kotlin: watchos, tvos.

Versión 1.8.0

14 de mayo de 2024

Lanzamiento de androidx.annotation:annotation-*:1.8.0. La versión 1.8.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.7.0

  • Se agregó la anotación @ReplaceWith para expresar los reemplazos de las APIs obsoletas
  • La anotación @MainThread se movió al conjunto de orígenes común.

Versión 1.8.0-rc01

1 de mayo de 2024

Lanzamiento de androidx.annotation:annotation-*:1.8.0-rc01. La versión 1.8.0-rc01 no contiene cambios con respecto a la versión beta anterior.

Versión 1.8.0-beta02

17 de abril de 2024

Lanzamiento de androidx.annotation:annotation-*:1.8.0-beta02. La versión 1.8.0-beta02 no contiene cambios desde la versión anterior.

Versión 1.8.0-beta01

3 de abril de 2024

Lanzamiento de androidx.annotation:annotation-*:1.8.0-beta01. La versión 1.8.0-beta01 contiene estas confirmaciones.

Nuevas funciones

  • La anotación ReplaceWith ahora es estable para la API, pero aún no se envió la comprobación de lint asociada con la corrección automática.

Versión 1.8.0-alpha02

20 de marzo de 2024

Lanzamiento de androidx.annotation:annotation-*:1.8.0-alpha02 sin cambios notables. La versión 1.8.0-alpha02 contiene estas confirmaciones.

Versión 1.8.0-alpha01

21 de febrero de 2024

Lanzamiento de androidx.annotation:annotation-*:1.8.0-alpha01. La versión 1.8.0-alpha01 contiene estas confirmaciones.

Cambios en la API

  • Se agregó la anotación @ReplaceWith para expresar los reemplazos de las APIs obsoletas. (I38db3, b/322373864).

Contribuciones externas

  • Agradecemos a Ivan Matkov por mover la anotación @MainThread al conjunto de orígenes común. (6f228c).

Versión 1.7

Versión 1.7.1

13 de diciembre de 2023

Lanzamiento de androidx.annotation:annotation-*:1.7.1. La versión 1.7.1 contiene estas confirmaciones.

Correcciones de errores

  • Usa el alcance compile cuando insertes la dependencia de la plataforma predeterminada. (I4958f).

Versión 1.7.0

6 de septiembre de 2023

Lanzamiento de androidx.annotation:annotation-*:1.7.0. La versión 1.7.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.6.0

  • Incluye artefactos multiplataforma de Kotlin orientados a plataformas iOS, Linux y macOS.
  • Ahora puedes usar anotaciones en proyectos KMM. Ten en cuenta que los objetivos de Annotations no relacionados con Android aún son experimentales, pero decidimos fusionar versiones para que los desarrolladores puedan probarlas con mayor facilidad. Específicamente, algunas anotaciones pueden moverse entre el código común y el específico de la plataforma durante el desarrollo alfa a medida que finalizamos los límites.

Versión 1.7.0-rc01

23 de agosto de 2023

Lanzamiento de androidx.annotation:annotation-*:1.7.0-rc01. La versión 1.7.0-rc01 contiene estas confirmaciones.

Esta versión no incluye cambios en comparación con la versión beta anterior.

Versión 1.7.0-beta01

9 de agosto de 2023

Lanzamiento de androidx.annotation:annotation-*:1.7.0-beta01. La versión 1.7.0-beta01 contiene estas confirmaciones.

Nuevas funciones

  • Se estabilizaron las APIs para el lanzamiento

Versión 1.7.0-alpha03

26 de julio de 2023

Lanzamiento de androidx.annotation:annotation-*:1.7.0-alpha03. La versión 1.7.0-alpha03 contiene estas confirmaciones.

Correcciones de errores

  • La publicación Maven POM ahora incluye como dependencia el artefacto multiplataforma predeterminado orientado a JVM.

Versión 1.7.0-alpha02

24 de marzo de 2023

Lanzamiento de androidx.annotation:annotation-*:1.7.0-alpha02.

Correcciones de errores

  • Se quitaron las restricciones de dependencia de los artefactos de Maven para solucionar un problema de compilación en los objetivos nativos de Kotlin (b/274786186, KT-57531).

Versión 1.7.0-alpha01

22 de marzo de 2023

Lanzamiento de androidx.annotation:annotation-*:1.7.0-alpha01. La versión 1.7.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

  • Incluye artefactos multiplataforma de Kotlin orientados a plataformas iOS, Linux y macOS.
  • Ahora puedes usar anotaciones en proyectos KMM. Ten en cuenta que los objetivos de Annotations no relacionados con Android aún son experimentales, pero decidimos fusionar versiones para que los desarrolladores puedan probarlas con mayor facilidad. Específicamente, algunas anotaciones pueden moverse entre el código común y el específico de la plataforma durante el desarrollo alfa a medida que finalizamos los límites.

Versión 1.6

Versión 1.6.0

22 de febrero de 2023

Se lanzaron androidx.annotation:annotation:1.6.0 y androidx.annotation:annotation-jvm:1.6.0. La versión 1.6.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.5.0

  • Se agregó una anotación @RequiresExtension para expresar que una API requiere una versión específica de un SDK de extensión determinado (I5e4fe).
  • Se convirtió la biblioteca de anotaciones para que compile con la cadena de herramientas multiplataforma de Kotlin (I3be8d).

Versión 1.6.0-rc01

8 de febrero de 2023

Se lanzaron androidx.annotation:annotation:1.6.0-rc01 y androidx.annotation:annotation-jvm:1.6.0-rc01. La versión 1.6.0-rc01 contiene estas confirmaciones.

  • Se estabilizó Annotation para la versión candidata 1.6.0-rc01.

Versión 1.6.0-beta01

25 de enero de 2023

Lanzamiento de androidx.annotation:annotation:1.6.0-beta01 y androidx.annotation:annotation-jvm:1.6.0-beta01 sin modificaciones desde 1.6.0-alpha01.

Versión 1.6.0-alpha01

11 de enero de 2023

Lanzamiento de androidx.annotation:annotation-*:1.6.0-alpha01. La versión 1.6.0-alpha01 contiene estas confirmaciones.

Versión 1.6.0-dev01

8 de febrero de 2023

Se lanzó androidx.annotation:annotation-*:1.6.0-dev01. La versión 1.6.0-dev01 contiene estas confirmaciones.

  • Annotation habilitó la versión multiplataforma de Kotlin para la vista preliminar para desarrolladores 1.6.0-dev01.

Nuevas funciones

  • Agrega una anotación @RequiresExtension para expresar que una API requiere una versión específica de un SDK de extensión determinado (I5e4fe).
  • Se convirtió la biblioteca de anotaciones para que compile con la cadena de herramientas multiplataforma de Kotlin (I3be8d).

Versión 1.5.0

Versión 1.5.0

21 de septiembre de 2022

Lanzamiento de androidx.annotation:annotation:1.5.0. La versión 1.5.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.4.0

  • La biblioteca de anotaciones se migró por completo a fuentes de Kotlin, lo que resultó en la compatibilidad con sitios de uso objetivo específicos de Kotlin y otras funciones de anotaciones compatibles con Kotlin.

Versión 1.5.0-rc01

7 de septiembre de 2022

Lanzamiento de androidx.annotation:annotation:1.5.0-rc01. La versión 1.5.0-rc01 contiene estas confirmaciones.

  • No hay cambios en la versión beta 1.5.0 anterior.

Versión 1.5.0-beta01

24 de agosto de 2022

Lanzamiento de androidx.annotation:annotation:1.5.0-beta01. La versión 1.5.0-beta01 contiene estas confirmaciones.

  • No hay cambios desde la versión anterior. Se congela la superficie de la API en la versión beta.

Versión 1.5.0-alpha02

10 de agosto de 2022

Lanzamiento de androidx.annotation:annotation:1.5.0-alpha02. La versión 1.5.0-alpha02 contiene estas confirmaciones.

  • Sin modificaciones desde la versión alfa anterior.

Versión 1.5.0-alpha01

27 de julio de 2022

Lanzamiento de androidx.annotation:annotation:1.5.0-alpha01. La versión 1.5.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

  • La biblioteca de anotaciones se migró por completo a fuentes de Kotlin, lo que resultó en la compatibilidad con sitios de uso objetivo específicos de Kotlin y otras funciones de anotaciones compatibles con Kotlin.

Versión 1.4.0

Versión 1.4.0

15 de junio de 2022

Se lanzó androidx.annotation:annotation:1.4.0. La versión 1.4.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.3.0

  • Se migró @RestrictTo a las fuentes de Kotlin y ahora admite el sitio de uso de @file. Como resultado, la biblioteca de anotaciones ahora depende de la biblioteca estándar de Kotlin.
  • @ReturnThis (b/140249763): Garantiza que los métodos de anulación de este método deben mostrar la misma instancia (para compiladores, etcétera).
  • @OpenForTesting (b/141539024): Las clases y los métodos de Kotlin marcados como "abiertos" se pueden anotar con esta anotación, y lint se asegurará de que esta clase solo tenga subclases (y los métodos solo estén anulados) de pruebas de unidades.
  • @DeprecatedSinceApi (b/37116481): Indica que el método con anotaciones (o la clase o el campo) es parte de una biblioteca de portabilidad a versiones anteriores para una API de plataforma, que ya no es necesaria a partir de un nivel de API determinado.
  • @EmptySuper: Indica que este método está definido para estar vacío, por lo que, cuando lo anulas, no necesitas llamarlo (y, de hecho, no debes hacerlo; por ejemplo, puede contener verificación de retrocompatibilidad).

Versión 1.4.0-rc01

1 de junio de 2022

Se lanzó androidx.annotation:annotation:1.4.0-rc01. La versión 1.4.0-rc01 contiene estas confirmaciones.

  • Se completaron la plataforma y la funcionalidad de la API para su lanzamiento.

Versión 1.4.0-beta01

18 de mayo de 2022

Se lanzó androidx.annotation:annotation:1.4.0-beta01. La versión 1.4.0-beta01 contiene estas confirmaciones.

  • No hubo cambios desde la última versión alfa. Se bloqueó la superficie de la API para la versión beta.

Versión 1.4.0-alpha02

9 de febrero de 2022

Lanzamiento de androidx.annotation:annotation:1.4.0-alpha02. La versión 1.4.0-alpha02 contiene estas confirmaciones.

Nuevas funciones

  • Se agregaron las anotaciones @ReturnThis, @OpenForTesting, @EmptySuper y @DeprecatedSinceApi (21946a2).

  • @ReturnThis (b/140249763): Garantiza que los métodos anulados de este método deben mostrar la misma instancia (para compiladores, etcétera).

  • @OpenForTesting (b/141539024): Las clases y los métodos de Kotlin marcados como "abiertos" se pueden anotar con esta anotación, y lint se asegurará de que esta clase solo tenga subclases (y los métodos solo estén anulados) de pruebas de unidades.

  • @DeprecatedSinceApi (b/37116481): Indica que el método con anotaciones (o la clase o el campo) es parte de una biblioteca de portabilidad a versiones anteriores para una API de plataforma, que ya no es necesaria a partir de un nivel de API determinado.

  • @EmptySuper: Indica que este método está definido para estar vacío, por lo que, cuando lo anulas, no necesitas llamarlo (y, de hecho, no debes hacerlo; por ejemplo, puede contener verificación de retrocompatibilidad).

Versión 1.4.0-alpha01

15 de diciembre de 2021

Lanzamiento de androidx.annotation:annotation:1.4.0-alpha01. La versión 1.4.0-alpha01 contiene estas confirmaciones.

Cambios en la API

  • Se migró la anotación RestrictTo a las fuentes de Kotlin (Ia6336).

Versión 1.3.0

Versión 1.3.0

3 de noviembre de 2021

Lanzamiento de androidx.annotation:annotation:1.3.0. La versión 1.3.0 contiene estas confirmaciones.

Cambios importantes desde 1.2.0

  • La anotación @Discouraged para marcar las API que no pueden dejar de estar disponibles de manera razonable, pero tienen un impacto negativo en el rendimiento y no deberían llamarse en el código normal de producción.
  • La anotación @Context para marcar contextos genéricos a fin de que los desarrolladores puedan migrar a las nuevas API con mayor facilidad.
  • La anotación @GravityInt para marcar elementos que contengan valores de gravedad empaquetados en números enteros.
  • @InspectableProperty dejó de estar disponible y se reemplazó por @Attribute para androidx.resourceinspection.

Versión 1.3.0-rc01

27 de octubre de 2021

Lanzamiento de androidx.annotation:annotation:1.3.0-rc01. La versión 1.3.0-rc01 contiene estas confirmaciones.

Versión 1.3.0-beta01

29 de septiembre de 2021

Lanzamiento de androidx.annotation:annotation:1.3.0-beta01. La versión 1.3.0-beta01 contiene estas confirmaciones.

Cambios en la API

  • Solicita una explicación en "message" para @Discouraged. (I3390f)
  • Se agregó una anotación @Discouraged para marcar los elementos no recomendados. (Ib2549)
  • Se permitió que la anotación RestrictTo sea visible en las ventanas emergentes de documentos de Studio. (Ie8e1a, b/183134648)

Correcciones de errores

  • Se agregó una anotación de Context para marcar contextos genéricos, de modo que los desarrolladores puedan migrar a las nuevas API con mayor facilidad. (Ie581a)

Versión 1.3.0-alpha01

24 de marzo de 2021

Lanzamiento de androidx.annotation:annotation:1.3.0-alpha01. La versión 1.3.0-alpha01 contiene estas confirmaciones.

Cambios en la API

  • @InspectableProperty dejó de estar disponible a favor de @Attribute en androidx.resourceinspection. (Ic0eff)
  • Se agregó la anotación @GravityInt para marcar elementos que contengan valores de gravedad empaquetados en números enteros. (Ifcaa4, b/180620048)

Annotation-Experimental versión 1.5

Versión 1.5.0-alpha01

21 de agosto de 2024

Lanzamiento de androidx.annotation:annotation-experimental:1.5.0-alpha01. La versión 1.5.0-alpha01 contiene estas confirmaciones.

Cambios en la API

  • Agrega message a RequiresOptIn para hacer coincidir la anotación stdlib de Kotlin con el valor de cadena vacío predeterminado. (I1f50e).

Annotation-Experimental versión 1.4

Versión 1.4.1

3 de abril de 2024

Lanzamiento de androidx.annotation:annotation-experimental:1.4.1. La versión 1.4.1 contiene estas confirmaciones.

Correcciones de errores

  • Corrige el uso de isKotlin para evitar activar accidentalmente la verificación RequiresOptIn en los archivos Kotlin. (I2d8c1f).

Versión 1.4.0

24 de enero de 2024

Lanzamiento de androidx.annotation:annotation-experimental:1.4.0. La versión 1.4.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.3.0

  • Cómo agregar compatibilidad con Kotlin multiplataforma
  • Cómo corregir la compatibilidad con Kotlin 2.0
  • Se mostraron advertencias sobre los usos de Java de propiedades de Kotlin con anotaciones experimentales. (I8bd43)
  • Se corrigió la posición de la anotación de corrección automática en los métodos de Kotlin. (Id7a41)

Versión 1.4.0-rc01

10 de enero de 2024

Lanzamiento de androidx.annotation:annotation-experimental:1.4.0-rc01. La versión 1.4.0-rc01 no contiene cambios desde la versión anterior.

Versión 1.4.0-beta01

13 de diciembre de 2023

Lanzamiento de androidx.annotation:annotation-experimental:1.4.0-beta01. No hay cambios desde la versión anterior.

Versión 1.4.0-alpha01

29 de noviembre de 2023

Lanzamiento de androidx.annotation:annotation-experimental:1.4.0-alpha01. La versión 1.4.0-alpha01 contiene estas confirmaciones.

Correcciones de errores

  • Quita temporalmente las sugerencias de corrección automática a nivel de la clase para solucionar b/301598518. (Id98b2).
  • Se mostraron advertencias sobre los usos de Java de propiedades de Kotlin con anotaciones experimentales. (I8bd43)
  • Se corrigió la posición de la anotación de corrección automática en los métodos de Kotlin. (Id7a41)

Versión 1.4.0-dev01

8 de febrero de 2023

Se lanzó androidx.annotation:annotation-experimental:1.4.0-dev01. La versión 1.4.0-dev01 contiene estas confirmaciones.

  • Annotation-experimental habilitó la versión multiplataforma de Kotlin para la vista preliminar para desarrolladores 1.4.0-dev01.

Annotation-Experimental versión 1.3.1

Versión 1.3.1

21 de junio de 2023

Lanzamiento de androidx.annotation:annotation-experimental:1.3.1. La versión 1.3.1 contiene estas confirmaciones.

Correcciones de errores

  • Coloca la anotación al principio de la lista de modificadores cuando apliques el ajuste automático de lint. (b/251172715).
  • Usa la comprobación de lint para desalentar el uso de androidx.annotation.RequiresOptIn en fuentes de Kotlin (b/241097743).

Annotation-Experimental versión 1.3.0

Versión 1.3.0

7 de septiembre de 2022

Lanzamiento de androidx.annotation:annotation-experimental:1.3.0. La versión 1.3.0 contiene estas confirmaciones.

Cambios importantes desde 1.2.0

  • Se agregó compatibilidad con el uso de @androidx.annotation.OptIn a nivel de paquete (I24d58).
  • Se trasladó la dependencia stdlib de Kotlin al tipo de API, en lugar de solo compilar. Esto significa que todos los clientes de la biblioteca Annotation-Experimental incluirán la biblioteca estándar de Kotlin en sus dependencias transitivas.

Versión 1.3.0-rc01

24 de agosto de 2022

Lanzamiento de androidx.annotation:annotation-experimental:1.3.0-rc01. La versión 1.3.0-rc01 contiene estas confirmaciones.

  • No hay cambios desde la versión anterior. La implementación se detuvo para RC.

Versión 1.3.0-beta01

10 de agosto de 2022

Lanzamiento de androidx.annotation:annotation-experimental:1.3.0-beta01. La versión 1.3.0-beta01 contiene estas confirmaciones.

  • No hay cambios desde la versión alfa. Esta biblioteca se estabilizó para la versión beta.

Versión 1.3.0-alpha01

27 de julio de 2022

Lanzamiento de androidx.annotation:annotation-experimental:1.3.0-alpha01. La versión 1.3.0-alpha01 contiene estas confirmaciones.

Cambios en la API

  • Se agregó compatibilidad con el uso de @androidx.annotation.OptIn a nivel de paquete (I24d58).

Annotation-Experimental versión 1.2.0

Versión 1.2.0

15 de diciembre de 2021

Lanzamiento de androidx.annotation:annotation-experimental:1.2.0. La versión 1.2.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.1.0

Esta biblioteca ahora está orientada al nivel de lenguaje Java 8.

Versión 1.2.0-rc01

1 de diciembre de 2021

Lanzamiento de androidx.annotation:annotation-experimental:1.2.0-rc01. La versión 1.2.0-rc01 contiene estas confirmaciones.

No hay cambios desde la versión beta.

Versión 1.2.0-beta01

17 de noviembre de 2021

Lanzamiento de androidx.annotation:annotation-experimental:1.2.0-beta01. La versión 1.2.0-beta01 contiene estas confirmaciones.

Cambios en la API

Se completaron las API para la versión beta.

Annotation-Experimental versión 1.2.0-alpha01

30 de junio de 2021

Lanzamiento de androidx.annotation:annotation-experimental:1.2.0-alpha01. La versión 1.2.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

  • La biblioteca ahora está orientada al nivel de lenguaje Java 8.

Versión 1.2.0

Versión 1.2.0

24 de marzo de 2021

Lanzamiento de androidx.annotation:annotation:1.2.0. La versión 1.2.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.1.0

  • Se agregó la anotación @ChecksSdkIntAtLeast, que se puede usar para identificar métodos o campos que brindan acceso a nivel del SDK y cumplir con la verificación NewApi de lint.
  • Se agregó la anotación @DoNotInline, que se vincula con una regla de Proguard para evitar que los miembros se intercalan durante la optimización.
  • Ahora, se incluye una variedad de anotaciones con @Documented a fin de garantizar que aparezcan en la documentación para los miembros anotados.

Versión 1.2.0-rc01

24 de febrero de 2021

Lanzamiento de androidx.annotation:annotation:1.2.0-rc01. La versión 1.2.0-rc01 contiene estas confirmaciones.

Versión 1.2.0-beta01

13 de enero de 2021

Lanzamiento de androidx.annotation:annotation:1.2.0-beta01. La versión 1.2.0-beta01 contiene estas confirmaciones.

Cambios en la API

  • La nueva anotación @DoNotInline indica a los optimizadores de código (p. ej., Proguard, R8) que no deben intercalar el método anotado. (I3dfe8, b/141326133)

Versión 1.2.0-alpha01

14 de mayo de 2020

Lanzamiento de androidx.annotation:annotation:1.2.0-alpha01. La versión 1.2.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

  • Se agregó la anotación @ChecksSdkIntAtLeast, que permite a androidx y los usuarios anotar métodos y campos que representen una verificación de SDK_INT. (I89a54, b/120255046)

Annotation-Experimental versión 1.1.0

Versión 1.1.0

7 de abril de 2021

Lanzamiento de androidx.annotation:annotation-experimental:1.1.0. La versión 1.1.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.0.0

  • Se volvieron a escribir las anotaciones experimentales de Jetpack en Kotlin para brindar compatibilidad con varias clases de marcadores y mejorar el manejo del proceso de baja.
  • Se agregaron anotaciones de RequiresOptIn y OptIn para lograr paridad con Kotlin, y las anotaciones de Experimental y UsesExperimental dejaron de estar disponibles.

Versión 1.1.0-rc02

24 de marzo de 2021

Lanzamiento de androidx.annotation:annotation-experimental:1.1.0-rc02. La versión 1.1.0-rc02 contiene estas confirmaciones.

Correcciones de errores

  • Se agregaron reglas de Proguard para garantizar que la optimización de código no advierta sobre las meta-anotaciones de Kotlin faltantes.

Versión 1.1.0-rc01

10 de marzo de 2021

Lanzamiento de androidx.annotation:annotation-experimental:1.1.0-rc01. La versión 1.1.0-rc01 contiene estas confirmaciones.

No hubo cambios desde la versión beta anterior.

Versión 1.1.0-beta01

27 de enero de 2021

Lanzamiento de androidx.annotation:annotation-experimental:1.1.0-beta01. La versión 1.1.0-beta01 contiene estas confirmaciones.

Cambios en la API

  • La variante de androidx de la anotación Experimental dejó de estar disponible para proporcionar paridad con Kotlin. Se reemplazó por una variante de androidx de la anotación RequiresOptIn, y se actualizó el linter orientado a Java para brindar compatibilidad con la nueva anotación de Kotlin y la nueva variante androidx. (I52495, b/151331381)

Versión 1.1.0-alpha01

22 de julio de 2020

Lanzamiento de androidx.annotation:annotation-experimental:1.1.0-alpha01. La versión 1.1.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

  • La biblioteca de anotaciones experimentales ahora está escrita en Kotlin, pero no requiere que se incluya la biblioteca estándar de Kotlin como una dependencia. Incluye un archivo ProGuard que permite quitar los metadatos de Kotlin innecesarios de los proyectos que solo usan el lenguaje de programación Java.
  • @UseExperimental ahora admite varias clases de marcadores (aosp/1185577, b/145137892).

Annotation-Experimental versión 1.0.0

Annotation-Experimental versión 1.0.0

7 de noviembre de 2019

Lanzamiento de androidx.annotation:annotation-experimental:1.0.0 y androidx.annotation:annotation-experimental-lint:1.0.0 sin modificaciones desde la versión 1.0.0-rc01. La versión 1.0.0 contiene estas confirmaciones.

Funciones principales de la versión 1.0.0

  • Aplicación basada en Lint de la semántica de Kotlin @Experimental en el código fuente de Java.
  • Anotaciones de Java que proporcionan un comportamiento equivalente a las anotaciones @Experimental y @UseExperimental de Kotlin sin la necesidad de tener una dependencia de Kotlin.

Annotation-Experimental versión 1.0.0-rc01

23 de octubre de 2019

Lanzamiento de androidx.annotation:annotation-experimental:1.0.0-rc01 y androidx.annotation:annotation-experimental-lint:1.0.0-rc01. La versión 1.0.0-rc01 contiene estas confirmaciones.

Errores conocidos

Cuando se usa Studio 3.5 estable, no se muestran las advertencias del detector de Lint de uso de @Experimental en el IDE para usos no válidos de Java de la anotación @Experimental de Kotlin. Consulta b/140640322.

Annotation-Experimental versión 1.0.0-beta01

9 de octubre de 2019

Lanzamiento de androidx.annotation:annotation-experimental:1.0.0-beta01 y androidx.annotation:annotation-experimental-lint:1.0.0-beta01 sin modificaciones desde la versión 1.0.0-alpha01. La versión 1.0.0-beta01 contiene estas confirmaciones.

Annotation-Experimental versión 1.0.0-alpha01

18 de septiembre de 2019

Lanzamiento de androidx.annotation:annotation-experimental:1.0.0-alpha01 y androidx.annotation:annotation-experimental-lint:1.0.0-alpha01. Estas son las confirmaciones incluidas en Annotation-Experimental1.0.0-alpha01, y estas son las conformaciones incluidas en Annotation-Experimental-Lint 1.0.0-alpha01.

Nuevas funciones

  • La biblioteca Annotation-Experimental de Jetpack proporciona una implementación compatible con Java de los marcadores de API experimentales de Kotlin. El artefacto con -lint proporciona una implementación basada en Lint de restricciones de uso experimentales y aplica restricciones sobre los usos de Java de los marcadores experimentales nativos de API de Kotlin.

  • Cuando se utiliza el artefacto con annotation-experimental como dependencia, las reglas de Lint que proporciona el artefacto con annotation-experimental-lint se aplican automáticamente.

Versión 1.1.0

Versión 1.1.0

5 de junio de 2019

Lanzamiento de androidx.annotation:annotation:1.1.0 sin modificaciones desde la versión 1.1.0-rc01.

Versión 1.1.0-rc01

7 de mayo de 2019

Lanzamiento de androidx.annotation:annotation:1.1.0-rc01 sin cambios desde 1.1.0-beta01. Para conocer las confirmaciones incluidas en esta versión, consulta este vínculo.

Versión 1.1.0-beta01

3 de abril de 2019

Lanzamiento de androidx.annotation:annotation:1.1.0-beta01. Para conocer las confirmaciones incluidas en esta versión, consulta este vínculo.

Nuevas funciones

  • Nueva anotación de @InspectableProperty para admitir las nuevas API de inspección de vistas que se agregaron en Android 10. Se puede aplicar a captadores en vistas u otros elementos de la IU. Las herramientas de generación de código pueden usarla para crear objetos complementarios que asignen nombres de propiedades e ID de atributos a valores de propiedades sin la sobrecarga de reflexión.

Cambios en la API

  • Cambio rotundo: se cambió @ContentView por una anotación de constructor y se quitó el valor de @LayoutRes. En las clases en la que se desee admitir anotaciones @ContentView, se deberá agregar esta anotación a un constructor que tome un parámetro @LayoutRes int. Esto soluciona un problema que se producía al usar esta anotación en los módulos de la biblioteca (b/128352521).

Versión 1.1.0-alpha02

13 de marzo de 2019

Lanzamiento de androidx.annotation:annotation:1.1.0-alpha02. Puedes ver la lista completa de las confirmaciones incluidas en esta versión en este vínculo.

Nuevas funciones

  • Nuevo alcance de restricción de API: RestrictTo.Scope.LIBRARY_GROUP_PREFIX. Restringe el uso al código dentro de los paquetes cuyos grupos comparten el mismo prefijo de grupo de biblioteca hasta el último . (punto). Por ejemplo, debido a que las bibliotecas foo.bar:lib1 y foo.baz:lib2 comparten el prefijo foo, pueden usar las respectivas API restringidas a este alcance. Del mismo modo, com.foo.bar:lib1 y com.foo.baz:lib2 comparten el prefijo com.foo. y pueden compartir API restringidas a ese alcance. Sin embargo, la biblioteca com.bar.qux:lib3 no podrá usar la API restringida porque solo comparte el prefijo com. y no hasta el último . (punto).

Versión 1.1.0-alpha01

30 de enero de 2019

Lanzamiento de androidx.annotation:annotation 1.1.0-alpha01.

Nuevas funciones

  • Se agregó una anotación @ContentView que te permite indicar qué archivo XML de diseño se debe inflar. Esto es compatible con ComponentActivity en la versión 1.0.0-alpha04 y Fragment en la versión 1.1.0-alpha04, como alternativa al uso de setContentView() o a la anulación de onCreateView(), respectivamente (aosp/837619).

Versión 1.0.2

Versión 1.0.2

25 de febrero de 2019

Lanzamiento de androidx.annotation:annotation 1.0.2.

Correcciones de errores

  • Se corrigieron las reglas de R8/ProGuard que están incorporadas en el archivo jar. Estas hacían una referencia incorrecta a los tipos de android.support.annotation anteriores, en lugar de androidx.annotation. Nota: Esto solo habría tenido un impacto en tus compilaciones si no usaras getDefaultProguardFile, ya que esas reglas predeterminadas también incluían reglas correctas para ambos paquetes (aosp/891685).
  • Se agregó una regla R8/ProGuard que mantiene la anotación @Keep de manera explícita. Esto garantiza que ProGuard no quite la anotación de los tipos antes de cumplir con su semántica. Nota: Esto solo habría tenido un impacto en tus compilaciones si no usaras getDefaultProguardFile, ya que esas reglas predeterminadas también incluían reglas correctas para ambos paquetes (aosp/903818).