Anotación
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-alpha02 |
annotation-experimental | 1.4.1 | - | - | 1.5.0-alpha01 |
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.8.2" // 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.8.2") // 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.
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-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
- Se agregó compatibilidad con la plataforma
mingwX64
(I461ca, b/349894318).
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 combinar las versiones para que los desarrolladores puedan probarlas más fácilmente. 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
paraandroidx.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
enandroidx.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
aRequiresOptIn
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ónRequiresOptIn
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 anotadas de forma experimental (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ónNewApi
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 deSDK_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
yOptIn
para lograr paridad con Kotlin, y las anotaciones deExperimental
yUsesExperimental
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 conannotation-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 bibliotecasfoo.bar:lib1
yfoo.baz:lib2
comparten el prefijofoo
, pueden usar las respectivas API restringidas a este alcance. Del mismo modo,com.foo.bar:lib1
ycom.foo.baz:lib2
comparten el prefijocom.foo.
y pueden compartir API restringidas a ese alcance. Sin embargo, la bibliotecacom.bar.qux:lib3
no podrá usar la API restringida porque solo comparte el prefijocom.
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 conComponentActivity
en la versión1.0.0-alpha04
yFragment
en la versión1.1.0-alpha04
, como alternativa al uso desetContentView()
o a la anulación deonCreateView()
, 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 deandroidx.annotation
. Nota: Esto solo habría tenido un impacto en tus compilaciones si no usarasgetDefaultProguardFile
, 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).