Tarjetas de Wear
Actualización más reciente | Versión estable | Versión potencial | Versión beta | Versión alfa |
---|---|---|---|---|
11 de diciembre de 2024 | 1.4.1 | - | - | 1.5.0-alpha05 |
Cómo declarar dependencias
Para agregar una dependencia en Wear, 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 { // Use to implement support for wear tiles implementation "androidx.wear.tiles:tiles:1.5.0-alpha04" // Use to utilize standard components and layouts in your tiles implementation "androidx.wear.protolayout:protolayout:1.3.0-alpha04" // Use to utilize components and layouts with Material Design in your tiles implementation "androidx.wear.protolayout:protolayout-material:1.3.0-alpha04" // Use to include dynamic expressions in your tiles implementation "androidx.wear.protolayout:protolayout-expression:1.3.0-alpha04" // Use to preview wear tiles in your own app debugImplementation "androidx.wear.tiles:tiles-renderer:1.5.0-alpha04" // Use to fetch tiles from a tile provider in your tests testImplementation "androidx.wear.tiles:tiles-testing:1.5.0-alpha04" }
Kotlin
dependencies { // Use to implement support for wear tiles implementation("androidx.wear.tiles:tiles:1.5.0-alpha04") // Use to utilize standard components and layouts in your tiles implementation("androidx.wear.protolayout:protolayout:1.3.0-alpha04") // Use to utilize components and layouts with Material Design in your tiles implementation("androidx.wear.protolayout:protolayout-material:1.3.0-alpha04") // Use to include dynamic expressions in your tiles implementation("androidx.wear.protolayout:protolayout-expression:1.3.0-alpha04") // Use to preview wear tiles in your own app debugImplementation("androidx.wear.tiles:tiles-renderer:1.5.0-alpha04") // Use to fetch tiles from a tile provider in your tests testImplementation("androidx.wear.tiles:tiles-testing:1.5.0-alpha04") }
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.5
Versión 1.5.0-alpha05
11 de diciembre de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.5.0-alpha05
. La versión 1.5.0-alpha05 contiene estas confirmaciones.
Nuevas funciones
- Se agregó la API para
TileService
para procesar eventos de interacción en lotes. (I04d1b)
Correcciones de errores
- Esta biblioteca ahora usa anotaciones de nulidad de JSpecify, que son de tipo de uso. Los desarrolladores de Kotlin deben usar los siguientes argumentos del compilador para aplicar el uso correcto:
-Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode
(I390e9, b/326456246). - Se corrigió el error por el que solicitar actualizaciones de tarjetas en el nivel de API 34 cuando el
targetSdk
de la app era superior a 34 causaba unSecurityException
(If62a1). - Se corrigió una dependencia de
WearSdk
en las pruebas de Robolectric. (I37796)
Versión 1.5.0-alpha04
13 de noviembre de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.5.0-alpha04
. La versión 1.5.0-alpha04 contiene estas confirmaciones.
Versión 1.5.0-alpha03
30 de octubre de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.5.0-alpha03
. La versión 1.5.0-alpha03 contiene estas confirmaciones.
Versión 1.5.0-alpha02
16 de octubre de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.5.0-alpha02
. La versión 1.5.0-alpha02 contiene estas confirmaciones.
Correcciones de seguridad
- A partir de este cambio, androidx compila con protobuf 4.28.2 para abordar el CVE-2024-7254. Actualiza la dependencia de la versión 1.5.0-alpha01 de
androidx.wear.tiles:tiles-proto
a la 1.5.0-alpha02 para abordar el riesgo de vulnerabilidad.
Versión 1.5.0-alpha01
2 de octubre de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.5.0-alpha01
. La versión 1.5.0-alpha01 contiene estas confirmaciones.
Versión 1.4
Versión 1.4.1
16 de octubre de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.4.1
. La versión 1.4.1 contiene estas confirmaciones.
Correcciones de seguridad
- A partir de este cambio, androidx compila con protobuf 4.28.2 para abordar el CVE-2024-7254. Actualiza la dependencia de la versión 1.4.0 de
androidx.wear.tiles:tiles-proto
a la 1.4.1 para abordar el riesgo de vulnerabilidad.
Versión 1.4.0
7 de agosto de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.4.0
. La versión 1.4.0 contiene estas confirmaciones.
Cambios importantes desde la versión 1.3.0
- Compatibilidad con herramientas para especificar datos de plataforma personalizados para las vistas previas de tarjetas en Android Studio.
Versión 1.4.0-rc01
24 de julio de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.4.0-rc01
sin cambios desde la versión anterior. La versión 1.4.0-rc01 contiene estas confirmaciones.
Versión 1.4.0-beta01
10 de julio de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.4.0-beta01
. La versión 1.4.0-beta01 contiene estas confirmaciones.
Nuevas funciones
La versión 1.4.0-beta01 de Wear Tiles indica que esta versión de la biblioteca está completa y la API está bloqueada (excepto donde se marca como experimental). Wear Tiles 1.4 incluye las siguientes APIs y funciones nuevas:
- Compatibilidad con herramientas para especificar datos de plataforma personalizados para las vistas previas de tarjetas en Android Studio.
Versión 1.4.0-alpha05
26 de junio de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.4.0-alpha05
. La versión 1.4.0-alpha05 contiene estas confirmaciones.
Versión 1.4.0-alpha04
29 de mayo de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.4.0-alpha04
. La versión 1.4.0-alpha04 contiene estas confirmaciones.
Versión 1.4.0-alpha03
14 de mayo de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.4.0-alpha03
. La versión 1.4.0-alpha03 contiene estas confirmaciones.
Correcciones de errores
TileService#getActiveTilesAsync
ahora usa la API deWearSdk
(cuando está disponible) para proporcionar un resultado más preciso. (I57bd8).
Versión 1.4.0-alpha02
1 de mayo de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.4.0-alpha02
. La versión 1.4.0-alpha02 contiene estas confirmaciones.
Cambios en la API
- Mueve
tileId
al parámetro del constructor de Builder como un campo obligatorio y documenta el valor predeterminado de la marca de tiempo en el método get. (I98c2b). - Agrega los mensajes de proto
TileInteractionEvent
,TileEnter
yTileLeave
, y los wrappers de Java necesarios para procesar por lotes los eventos de entrada o salida de tarjetas. (I112b0). - Refactoriza
TileRenderer
para usar un compilador en lugar de un objetoTileRenderer.Config
. (Ib66f9). - Agrega un atributo
platformDataProviders
aTileRenderer.Config
. (I6030d). - Se agregó un nuevo constructor a
TileRenderer
que admite una nueva claseTileRenderer.Config
. Otros constructores dejaron de estar disponibles. (Iae7ff). - Agrega un campo
platformDataValues
aTilePreviewData
para permitir anular los valores de datos de la plataforma. (If437a).
Correcciones de errores
- Documenta que el valor predeterminado de
TileRenderer.Config.Builder#setTilesTheme
es cero. (Iced18).
Versión 1.4.0-alpha01
6 de marzo de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.4.0-alpha01
. La versión 1.4.0-alpha01 contiene estas confirmaciones.
Versión 1.3
Versión 1.3.0
7 de febrero de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.3.0
. La versión 1.3.0 contiene estas confirmaciones.
Cambios importantes desde 1.2.0
- Se actualizaron las herramientas para admitir la vista previa de tarjetas.
- Compatibilidad para consultar tarjetas activas que pertenecen a la app.
Cambios adicionales
- Para obtener un conjunto más completo de los cambios introducidos en la versión 1.3.0, consulta las notas de la versión beta01.
Versión 1.3.0-rc01
24 de enero de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.3.0-rc01
. La versión 1.3.0-rc01 contiene estas confirmaciones.
Cambios en la API
- Se cambió el nombre de
TileService#getActiveTilesSnapshotAsync
agetActiveTilesAsync
. (If6b87).
Versión 1.3.0-beta01
10 de enero de 2024
Lanzamiento de androidx.wear.tiles:tiles-*:1.3.0-beta01
. La versión 1.3.0-beta01 contiene estas confirmaciones.
La versión 1.3.0-beta01 de Wear Tiles indica que esta versión de la biblioteca está completa y la API está bloqueada (excepto donde se marca como experimental). Wear Tiles 1.3 incluye las siguientes APIs y funciones nuevas:
- Se actualizó el módulo de herramientas de tarjetas para Wear para admitir la vista previa de tarjetas y se configuró para publicarse.
- Compatibilidad para consultar qué tarjetas que pertenecen a la app están activas con
TileService.getActiveTilesSnapshotAsync
.
Versión 1.3.0-alpha04
13 de diciembre de 2023
Lanzamiento de androidx.wear.tiles:tiles-*:1.3.0-alpha04
. La versión 1.3.0-alpha04 contiene estas confirmaciones.
Versión 1.3.0-alpha03
29 de noviembre de 2023
Lanzamiento de androidx.wear.tiles:tiles-*:1.3.0-alpha03
. La versión 1.3.0-alpha03 contiene estas confirmaciones.
Nuevas funciones
- Se agregó una nueva API
TileService#getActiveTilesSnapshotAsync
para consultar qué tarjetas que pertenecen a la app están activas. (I6850e).
Cambios en la API
- Se cambió el nombre de
@TilePreview
a@Preview
(Ifc08a).
Versión 1.3.0-alpha02
15 de noviembre de 2023
Lanzamiento de androidx.wear.tiles:tiles-*:1.3.0-alpha02
. La versión 1.3.0-alpha02 contiene estas confirmaciones.
Nuevas funciones
- Agregamos una API experimental para escalar automáticamente el tamaño del texto según el espacio que tiene dentro del elemento superior. (Ibbe63).
Versión 1.3.0-alpha01
18 de octubre de 2023
Lanzamiento de androidx.wear.tiles:tiles-*:1.3.0-alpha01
. La versión 1.3.0-alpha01 contiene estas confirmaciones.
Nuevas funciones
- Proporciona el contexto como un parámetro del método de vista previa en lugar de los parámetros de devolución de llamada de
TilePreviewData
. (I5e97d) - Se actualizó el módulo de herramientas de tarjetas para Wear para admitir la vista previa de tarjetas y se configuró para publicarse. (I63d0f).
Versión 1.2
Versión 1.2.0
9 de agosto de 2023
Lanzamiento de androidx.wear.tiles:tiles-*:1.2.0
. La versión 1.2.0 contiene estas confirmaciones.
Cambios importantes desde la versión 1.1.0
- Versión estable de Wear Tiles 1.2.0 (más información)
- Tiles 1.2 agrega compatibilidad con la vinculación de elementos de diseño a datos de la plataforma (para actualizaciones más rápidas) y animación. Para obtener instrucciones de migración, consulta las notas de la versión (1.2.0-rc01).
Versión 1.2.0-rc01
26 de julio de 2023
Lanzamiento de androidx.wear.tiles:tiles-*:1.2.0-rc01
. La versión 1.2.0-rc01 contiene estas confirmaciones.
Con la versión 1.2, se refactorizó la biblioteca de tarjetas, y la mayoría de las funciones y APIs se trasladaron a la nueva biblioteca de ProtoLayout (paquete
androidx.wear.protolayout
), con un pequeño subconjunto que queda en tarjetas (androidx.wear.tiles
):- Los nombres de todas las clases siguen siendo los mismos, solo se agregaron elementos a la v1.1.
- La mayoría de las APIs siguen siendo las mismas, y el único cambio es el nombre del paquete.
- Algunos de los métodos de
TileService/TileBuilder
dejaron de estar disponibles y ahora tienen versiones con nombres nuevos que aceptan nuevos tipos deProtoLayout
en lugar de los de tarjetas obsoletos.
Para facilitar esta migración, creamos una pequeña secuencia de comandos y unas instrucciones que realizan este cambio de nombre. Consulta aquí.
Cambios en la API
- Limitamos la profundidad máxima que puede tener un diseño a 30 elementos anidados en la tarjeta. Si se supera esa profundidad, el renderizador de tarjetas mostrará un diseño inflado anteriormente. (I8a74b)
Versión 1.2.0-beta01
21 de junio de 2023
Se lanzó androidx.wear.tiles:tiles-*:1.2.0-beta01
sin cambios. La versión 1.2.0-beta01 contiene estas confirmaciones.
Versión 1.2.0-alpha07
7 de junio de 2023
Lanzamiento de androidx.wear.tiles:tiles-*:1.2.0-alpha07
. La versión 1.2.0-alpha07 contiene estas confirmaciones.
Nuevas funciones
TileRenderer.setState
permite establecer el estado de la sesión de renderización. Este estado se aplicará al diseño actual y a cualquier otro futuro (hasta que se establezca un estado nuevo) (Iaaf35).- Los tipos de protolayout ahora son totalmente compatibles con todas las APIs de renderizador de mosaicos. (I428b0).
Correcciones de errores
- Ahora es posible establecer un tema personalizado en
ProtoLayoutViewInstance
. (Iae8c0)
Versión 1.2.0-alpha06
24 de mayo de 2023
Lanzamiento de androidx.wear.tiles:tiles-*:1.2.0-alpha06
. La versión 1.2.0-alpha06 contiene estas confirmaciones.
Cambios en la API
- Se cambió el nombre de
StateEntryValue
porDynamicDataValue
y se actualizaron las APIs de estado para usarDynamicDataKey
(If1c01). - Limitamos la cantidad de entradas permitidas en
StateStore
para garantizar que el uso de la memoria y el tiempo de actualización de estado estén bien contenidos y controlados para cada instancia deStateStore
. Como resultado, el desarrollador debe asegurarse de no tener más deMAX_STATE_ENTRY_COUNT
entradas en el mapa; de lo contrario, recibirá unIllegalStateException
cuando cree o actualice elStateStore
. (Ibadb3).
Versión 1.2.0-alpha05
10 de mayo de 2023
Lanzamiento de androidx.wear.tiles:tiles-*:1.2.0-alpha05
. La versión 1.2.0-alpha05 contiene estas confirmaciones.
Nuevas funciones
- Agregamos el ID de tarjeta a los eventos y solicitudes de tarjetas. Este ID se puede usar para asociar algunos datos con una instancia de tarjeta en el carrusel. (Ic4f83).
Cambios en la API
TileRenderer.inflateAsync
ahora muestra unListenableFuture
. (I2f2b9).- Los compiladores de tarjetas que tienen un reemplazo en la biblioteca
protolayout
ahora se marcan como obsoletos. (Ie2029).
Correcciones de errores
- El javadoc de
TileService.onTileResourcesRequest
ahora aclara cuándo el sistema podría llamar al método. (Iee037).
Versión 1.2.0-alpha04
19 de abril de 2023
Lanzamiento de androidx.wear.tiles:tiles-*:1.2.0-alpha04
. La versión 1.2.0-alpha04 contiene estas confirmaciones.
Correcciones de errores
- Las dependencias de Gradle ahora se configuran correctamente en
api
en lugar deimplementation
cuando es necesario. (I40503)
Versión 1.2.0-alpha03
5 de abril de 2023
Lanzamiento de androidx.wear.tiles:tiles-*:1.2.0-alpha03
. La versión 1.2.0-alpha03 contiene estas confirmaciones.
Cambios en la API
- Se agregó compatibilidad con los tipos
androidx.wear.protolayout
aTileRenderer
(I4ac7f). - El nombre de
ObservableStateStore
cambió porStateStore
. (Ieb0e2). - Se agregaron sobrecargas para los tipos de protolayout a
TileRenderer
(I4ac7f). - Habilita las animaciones en
TileRenderer
(I07dcf).
Versión 1.2.0-alpha02
22 de marzo de 2023
Lanzamiento de androidx.wear.tiles:tiles-*:1.2.0-alpha02
. La Versión 1.2.0-alpha02 contiene estas confirmaciones.
Cambios en la API
- La biblioteca de Tiles Material dejó de estar disponible. Usa la nueva biblioteca
ProtoLayout Material
con las mismas funcionalidades. (If242b).
Correcciones de errores
TileRenderer
se actualizó para usar funciones nuevas de la biblioteca de protolayout. (I832f9)
Versión 1.2.0-alpha01
8 de marzo de 2023
Lanzamiento de androidx.wear.tiles:tiles-*:1.2.0-alpha01
. La versión 1.2.0-alpha01 contiene estas confirmaciones.
Nuevas funciones
- Se agregó
onTileResourceRequest
aTileService
para proporcionar recursos de la bibliotecaprotolayout
. (983d9c5). - Actualizamos
ResourcesRequest
yTileRequest
para admitir los tiposState
yDeviceParameters
de la bibliotecaprotolayout
. (88fa01d). - Actualizamos
TileBuilders.Tile
para admitir los tiposState
yTimeline
de la bibliotecaprotolayout
. (168619c).
Correcciones de errores
- Se realizaron mejoras en Javadoc. (I3ed73).
- Cambiaron los colores predeterminados de
onPrimary
y la superficie. (I0b039).
Versión 1.1
Versión 1.1.0
24 de agosto de 2022
Lanzamiento de androidx.wear.tiles:tiles-*:1.1.0
. La versión 1.1.0 contiene estas confirmaciones.
Cambios importantes desde 1.0.0
- Esta es la primera versión estable que contiene la biblioteca de Tiles Material (obtén más información en nuestro blog).
- Esta biblioteca contiene componentes y diseños que cumplen con los lineamientos de Material y son fáciles de usar. Los componentes incluidos son
Button
,Chip
,CompactChip
,TitleChip
,CircularProgressIndicator
yText
. Todos estos componentes tienen su propio objeto de colores que se puede compilar con la clase Colors principal para aplicar fácilmente el mismo tema en todos los componentes. Además de los colores, hay una clase Typography para obtener objetos FontStyle fácilmente con el nombre de la tipografía. - Además de los componentes, hay diseños de tarjetas recomendados:
PrimaryLayout
,EdgeContentLayout
,MultiButtonLayout
yMultiSlotLayout
. Todos los diseños tienen padding y estilos recomendados aplicados que cumplen con los lineamientos de Material. - Para obtener una lista de los componentes y diseños en la biblioteca de Tiles Material, consulta las notas de la versión de Tiles.
Versión 1.1.0-rc01
10 de agosto de 2022
Lanzamiento de androidx.wear.tiles:tiles-*:1.1.0-rc01
. La versión 1.1.0-rc01 contiene estas confirmaciones.
- No hubo cambios entre la versión beta y la versión RC.
Versión 1.1.0-beta01
27 de julio de 2022
Lanzamiento de androidx.wear.tiles:tiles-*:1.1.0-beta01
. La versión 1.1.0-beta01 contiene estas confirmaciones.
La versión 1.0.0-beta01 de la biblioteca de tarjetas de Material contiene componentes y diseños que cumplen con los lineamientos de Material y son fáciles de compilar.
Los componentes incluidos son los siguientes:
Button
: Objeto de forma circular en el que se puede hacer clic, con un ícono, texto o imagen con 3 tamaños predefinidos.Chip
: Es un objeto con forma de estadio en el que se puede hacer clic y que puede contener un ícono, etiquetas principales y secundarias, y una altura fija y un ancho personalizable.CompactChip
yTitleChip
: Son dos variaciones del chip estándar que tienen alturas más pequeñas y más grandes, respectivamente, y pueden contener una línea de texto.CircularProgressIndicator
: Es un arco de color alrededor del borde de la pantalla con los ángulos de inicio y finalización especificados, que puede describir un círculo completo o parcial con el arco de progreso completo detrás.Text
: Corresponde a texto con estilo que usa los estilos de tipografía recomendados de Material para Wear.
Todos estos componentes tienen su propio objeto de colores de componibilidad con la clase Colors
principal para aplicar fácilmente el mismo tema en todos los componentes. Además de los colores, hay una clase Typography
para obtener objetos FontStyle
con facilidad mediante el nombre de la tipografía.
Además de los componentes, hay diseños de mosaicos recomendados:
PrimaryLayout
: Es un diseño que se puede personalizar agregando etiquetas primarias o secundarias, contenido en el medio y un chip principal en la parte inferior. El contenido principal de este diseño podría agregarse como un objetoMultiSlotLayout
oMultiButtonLayout
.EdgeContentLayout
: Es un diseño para alojarCircularProgressIndicator
alrededor del perímetro con contenido principal dentro y una etiqueta principal o secundaria.MultiButtonLayout
: Es un diseño que puede contener de 1 a 7 botones, organizados de acuerdo con los lineamientos de Material según su número.MultiSlotLayout
: Es un diseño de estilo de fila con ranuras alineadas horizontalmente y con espacios (para íconos y otro contenido pequeño).
Todos los diseños tienen padding y estilos recomendados aplicados que cumplen con los lineamientos de Material.
Cambios en la API
- Hicimos una importante reestructuración de los componentes del chip, que incluye métodos set separados en Builder, para que cada parte del contenido se pase por separado y se cambie el nombre para que coincida con los lineamientos (etiqueta principal, etiqueta secundaria, ID de recurso de imagen). Además, la descripción del contenido se generará automáticamente si no se establece (I57622).
- Se cambió el nombre de
ProgressIndicatorLayout
porEdgeContentLayout
(Ic1aa6). - Se cambió el nombre del contenido del tamaño del botón por el sufijo
without _BUTTON
con aclaraciones adicionales de Javadocs enButton
(I1dfe2).
Correcciones de errores
- Se actualizaron los márgenes, el padding y la disposición general en Material Layouts para adaptarse a todos los tipos de diseños y tamaños de pantalla recomendados, además de formas.
- Implementamos mejoras en Material Layouts. En
MultiSlotLayout
, las ranuras ahora tienen un ancho flexible en el que se unirá el contenido en lugar de ser de tamaño fijo (I52919, If18b4). - Se aumentó el área que se puede presionar en
CompactChip
para seguir los lineamientos de accesibilidad (Ie8264).
Versión 1.1.0-alpha09
29 de junio de 2022
Se lanzó androidx.wear.tiles:tiles-*:1.1.0-alpha09
. La versión 1.1.0-alpha09 contiene estas confirmaciones.
Nuevas funciones
- Se agregó compatibilidad para agregar etiquetas opcionales en
ProgressIndicatorLayout
(I30788).
Cambios en la API
- Los métodos auxiliares de
ElementMetadata
ahora aceptanElementMetadata
en lugar de modificadores (I5a70f).
Correcciones de errores
- Se quitó la limitación de 9 caracteres en
CompactChip
. Si el texto es demasiado grande para caber en la pantalla enPrimaryLayout
, se reducirá (Id56ec). - Los métodos get en
Chip
ahora tienen el sufijo Content (Iba437). - Aclaración de Javadoc en las clases de tarjetas de Material (I56e41), (I80f31), (Iba437).
Versión 1.1.0-alpha08
1 de junio de 2022
Se lanzó androidx.wear.tiles:tiles-*:1.1.0-alpha08
. La versión 1.1.0-alpha08 contiene estas confirmaciones.
Nuevas funciones
- Se agregó la etiqueta de metadatos a los modificadores para hacer un seguimiento de los metadatos del componente con métodos auxiliares agregados a la clase
Helper
(I70db2),(I30c3d). - Se agregó el método estático
fromLayoutElement
a todos los componentes y diseños en Tiles Material. Debe usarse para pruebas, a fin de transmitir un LayoutElement, obtenido después de acceder al contenido de un contenedor, a su tipo original (Ia572a),(Idbd8a),(I3ae13),(I292fe),(I8b20f),(I3cacb),(I84b24).
Versión 1.1.0-alpha07
18 de mayo de 2022
Se lanzó androidx.wear.tiles:tiles-*:1.1.0-alpha07
. La versión 1.1.0-alpha07 contiene estas confirmaciones.
Cambios en la API
- Se agregaron métodos get relacionados con diferentes métodos set para contenido a
ProgressIndicatorLayout
yPrimaryLayout
. Ahora, todos los métodos set de estas clases tienen métodos get que coinciden (Iddbe5) (Iabe4e). - El método get para la descripción del contenido en los Componentes de Material puede mostrar un valor nulo, ya que su método set no es obligatorio.
- Si intentas crear un botón sin contenido, se generará
IllegalArgumentException
(I7fc0c). - Los campos relacionados con el color de los íconos en
ChipColors
cambiaron de nombre deiconTintColor
aiconColor
(Ic053b).
Correcciones de errores
- Se agregó
androidTests
para diseños en Tiles Material (I96404).
Versión 1.1.0-alpha06
11 de mayo de 2022
Se lanzó androidx.wear.tiles:tiles-*:1.1.0-alpha06
. La versión 1.1.0-alpha06 contiene estas confirmaciones.
Nuevas funciones
- Se agregó el nuevo diseño a la subbiblioteca de Material Layouts:
MultiButtonLayout
. Representa un diseño que puede contener entre 1 y 7 botones organizados de acuerdo con los lineamientos de Material. En la mayoría de los casos, este diseño se debe pasar como contenido a PrimaryLayout (Ib727f).
Cambios en la API
- Se refactorizó
MultiSlotLayout
para que solo tenga ranuras. Este diseño se debe pasar como contenido al elementoPrimaryLayout
principal (I1870f). - Se actualizaron los colores predeterminados definidos para
CircularProgressIndicator
a un valor en lugar de primario y secundario (I64a51). - Se agregó un método get para el espaciador horizontal en
MultiSlotLayout
(I11e1e).
Correcciones de errores
- Se agregaron pruebas de componentes de Android a Tiles Material (I20041).
Versión 1.1.0-alpha05
6 de abril de 2022
Se lanzó androidx.wear.tiles:tiles-*:1.1.0-alpha05
. La versión 1.1.0-alpha05 contiene estas confirmaciones.
Nuevas funciones
- Se agregaron métodos auxiliares para convertir
LayoutElement
a Layout, Timeline y TimelineEntry en estas clases para facilitar la compilación de tarjetas (I2f6d1). - Se agregó el objeto
Colors
a la biblioteca de Material para que se pase en colores de componentes como un tema (I0792c).
Cambios en la API
- El componente de Material Text requiere texto que se pase al constructor. Ahora se puede personalizar este componente con la configuración del peso (I25dbd)
- Se quitaron las constantes de
ChipDefaults
que no se usan en los métodos set públicos (I7baed). - Se quitaron los métodos get de
CompactChip
yTitleChip
que no tienen métodos set que coincidan (I99e85). - Se quitó
DEFAULT_PADDING
deProgressIndicatorDefaults
(Idabcd). - Los componentes de Material ahora aceptan
CharSequence
para la descripción de contenido en lugar de String (I5b21a).
Correcciones de errores
- Se refactorizó la implementación de métodos set de parámetros opcionales en Button (Ib7135).
- Se agregó la variante de estilo de fuente a las fuentes en Typography (I8dbc6).
Versión 1.1.0-alpha04
23 de marzo de 2022
Se lanzó androidx.wear.tiles:tiles-*:1.1.0-alpha04
. La versión 1.1.0-alpha04 contiene estas confirmaciones.
Nuevas funciones
- Se puede agregar una etiqueta principal o secundaria opcional a
PrimaryLayout
(Ib9916). - El componente de texto se puede personalizar si se establece una configuración de desbordamiento, cursiva, subrayado, etcétera (I703f7).
Cambios en la API
- Se quitaron las constantes de color predeterminadas de la API de Tiles Material (I0ab55).
- Todos los componentes en los que se puede hacer clic en Tiles Material requieren el objeto
Clickable
en el constructor de su compilador en lugar de una acción (I2f101).
Correcciones de errores
- El texto ahora hará una elipsis sobre el desbordamiento en el componente Chip y Text (I8a2f8).
- Los componentes mejorados se ven cuando la escala de fuente del usuario se establece en grande (Ib63b1).
- Se aclaró Javadocs de
setPrimaryChipContent
en PrimaryLayout (Ie6296).
Versión 1.1.0-alpha03
23 de febrero de 2022
Se lanzó androidx.wear.tiles:tiles-*:1.1.0-alpha03
. La versión 1.1.0-alpha03 contiene estas confirmaciones.
Cambios en la API
- Se agregó el componente
Text
con los estilos de tipografía recomendados a Tiles Material (Iec0ae).
Versión 1.1.0-alpha02
9 de febrero de 2022
Se lanzó androidx.wear.tiles:tiles-*:1.1.0-alpha02
. La versión 1.1.0-alpha02 contiene estas confirmaciones.
Nuevas funciones
- Se agregó una nueva subbiblioteca
layouts
, en Tiles Material. Contiene diseños llamativos con los paddings y los márgenes recomendados ya aplicados para que el desarrollo de tarjetas sea más rápido y que su que implementación sea más fácil. Los diseños iniciales son los siguientes:PrimaryLayout
(I7ba91) que representa el diseño con un chip principal en la parte inferior y contenido en el centro.MultiSlotLayout
(I32104) que representa un diseño con etiquetas en las filas 1 y 3, alineadas horizontalmente y con espacios separados en la fila 2, todas seguidas de una cuarta fila que contiene un chip principal.ProgressIndicatorLayout
(I9fec6) que representa un diseño con el indicador de progreso circular alrededor del borde de la pantalla y el contenido dado dentro de él.
- Se agregó
CircularProgressIndicator
(Ic4b88) a los componentes de Tiles Material.
Cambios en la API
- Se cambió el nombre de las constantes restantes que usa
TitleChip
para incluir el título en el nombre (I14f4c). - Se agregó el método
setHorizontalAlignment
aChip
(Ie6e0b).
Versión 1.1.0-alpha01
26 de enero de 2022
Se lanzó androidx.wear.tiles:tiles-*:1.1.0-alpha01
. La versión 1.1.0-alpha01 contiene estas confirmaciones.
Nuevas funciones
- Se agregó la nueva biblioteca de Tiles Material. Contiene componentes para crear diseños de mosaico más rápido y fácil con Material Design. Los componentes iniciales son los siguientes:
Button
Chip
CompactChip
TitleChip
Correcciones de errores
- Se corrigió un error en
TileUiClient
que provocaba que se descartaran los recursos almacenados en caché (I60e0b).
Versión 1.0
Versión 1.0.1
26 de enero de 2022
Se lanzó androidx.wear.tiles:tiles-*:1.0.1
. La versión 1.0.1 contiene estas confirmaciones.
Correcciones de errores
- Se corrigió un error en
TileUiClient
que provocaba que se descartaran los recursos almacenados en caché (I60e0b).
Versión 1.0.0
3 de noviembre de 2021
Se lanzó androidx.wear.tiles:tiles-*:1.0.0
. La versión 1.0.0 contiene estas confirmaciones.
Funciones principales de la versión 1.0.0
- La biblioteca de las Tarjetas de Wear proporciona funcionalidad a fin de crear tarjetas personalizadas para dispositivos Wear OS, junto con las clases que permiten que el sistema recupere tu tarjeta y la muestre junto a la cara de reloj.
- tiles-renderer permite mostrar una tarjeta como parte de una actividad de Android, lo que facilita las pruebas rápidas de los diseños de tarjetas.
Versión 1.0.0-rc01
27 de octubre de 2021
Lanzamiento de androidx.wear.tiles:tiles-*:1.0.0-rc01
. La versión 1.0.0-rc01 contiene estas confirmaciones.
Versión 1.0.0-beta01
13 de octubre de 2021
Se lanzó androidx.wear.tiles:tiles-*:1.0.0-beta01
. La versión 1.0.0-beta01 contiene estas confirmaciones.
Correcciones de errores
- Se corrigió
NullPointerException
enTileUiClient
cuando se brindaba una versión vacía del recurso (I0586e).
Versión 1.0.0-alpha12
29 de septiembre de 2021
Se lanzó androidx.wear.tiles:tiles-*:1.0.0-alpha12
. La versión 1.0.0-alpha12 contiene estas confirmaciones.
Correcciones de errores
UpdateScheduler ya no usa una referencia débil, lo que corrige problemas en los que TileUiClient no se actualizaba (I1120d, b/199061124).
Se declaran las búsquedas de SysUiTileUpdateRequester a PacakgeManager, lo que soluciona el error en el que las actualizaciones de las tarjeta no funcionaban en los dispositivos de R+ (I1120d).
Versión 1.0.0-alpha11
1 de septiembre de 2021
Se lanzó androidx.wear.tiles:tiles-*:1.0.0-alpha11
. La versión 1.0.0-alpha11 contiene estas confirmaciones.
Nuevas funciones
- Se agregó y lanzó una biblioteca de pruebas, la biblioteca androidx.wear.tiles:tiles-testing, para que los desarrolladores puedan probar sus tarjetas con mayor facilidad (Iedb6b).
Cambios en la API
- Se cambió el nombre de TileProviderService por TileService (I1ad2c).
- Se actualizaron los compiladores de tarjetas; los métodos estáticos
.builder()
dejaron de estar disponibles y se los reemplazó por llamar anew Foo.Builder()
, y se quitaron las sobrecargas de método set que aceptaban una instancia deBuilder
(Ia9606). - Ahora, TileRenderer debe usar un contexto de IU, en lugar del contexto de la aplicación (I84b61).
Correcciones de errores
- Se corrigió el error que causaba que se aplicaran varios subrayados en determinadas situaciones (Ib6712).
Versión 1.0.0-alpha10
18 de agosto de 2021
Se lanzaron androidx.wear.tiles:tiles:1.0.0-alpha10
, androidx.wear.tiles:tiles-proto:1.0.0-alpha10
y androidx.wear.tiles:tiles-renderer:1.0.0-alpha10
. La versión 1.0.0-alpha10 contiene estas confirmaciones.
Cambios en la API
- Se quitaron los verificadores de diseño de la API pública. Siempre estarán habilitados, aunque solo se mostrará una advertencia si falla una verificación (Ie9f29).
- Ahora, TileRenderer acepta un contexto de IU, en lugar del contexto de la aplicación.
Correcciones de errores
- Se corrigió el error que impedía que se pudiera hacer clic los elementos en los que se puede realizar esta acción.
Versión 1.0.0-alpha09
21 de julio de 2021
Se lanzaron androidx.wear.tiles:tiles:1.0.0-alpha09
, androidx.wear.tiles:tiles-proto:1.0.0-alpha09
y androidx.wear.tiles:tiles-renderer:1.0.0-alpha09
. La versión 1.0.0-alpha09 contiene estas confirmaciones.
Nuevas funciones
- Se agregaron verificadores de diseño al procesador de las Tarjetas de Wear. (I3a869)
- Estos se usan para validar las prácticas recomendadas en las tarjetas. Para comenzar, se producirá una advertencia si tu tarjeta no contiene algún elemento con un modificador
Semantics
.
- Estos se usan para validar las prácticas recomendadas en las tarjetas. Para comenzar, se producirá una advertencia si tu tarjeta no contiene algún elemento con un modificador
- Se agregó documentación para
DefaultTileProviderClient
yTestingTileProviderClient constructors
. (I9f4b9)
Cambios en la API
- Cambios de nombre en TileProviderClient. (I0ec36):
getApiVersion
->requestApiVersion
tile/resourcesRequest
->requestTile/Resources
onTileFooEvent
->sendOnTileFooEvent
- Se agregaron verificadores de diseño al procesador de las Tarjetas de Wear. (I3a869)
Correcciones de errores
- Asegúrate de que el objetivo de LaunchAction no tenga permisos especiales. (I39136)
Versión 1.0.0-alpha08
30 de junio de 2021
Se lanzaron androidx.wear.tiles:tiles:1.0.0-alpha08
, androidx.wear.tiles:tiles-proto:1.0.0-alpha08
y androidx.wear.tiles:tiles-renderer:1.0.0-alpha08
. La versión 1.0.0-alpha08 contiene estas confirmaciones.
Nuevas funciones
- Ahora, Spannables admite line_height en lugar de line_spacing.
Cambios en la API
- Se agregó compatibilidad con line_height en Spannables y se quitó line_spacing. (Ibeb54)
- El código que usa line_spacing se debe transferir para usar en cambio line_height.
Correcciones de errores
- Se corrigió el error que se produce cuando se usan dimensiones proporcionales. (I37ace)
- Se corrigió el error que impide que los elementos de texto tengan descripciones de contenido. (Id2c7d)
Versión 1.0.0-alpha07
16 de junio de 2021
Se lanzaron androidx.wear.tiles:tiles:1.0.0-alpha07
, androidx.wear.tiles:tiles-proto:1.0.0-alpha07
y androidx.wear.tiles:tiles-renderer:1.0.0-alpha07
. La versión 1.0.0-alpha07 contiene estas confirmaciones.
Cambios en la API
- Agrega la interfaz
TileProviderClient
y exponeDefaultTileProviderClient
, lo que permite que las implementaciones se vinculen a una interfazTileProviderService
. (I69165)
Versión 1.0.0-alpha06
2 de junio de 2021
Se lanzaron androidx.wear.tiles:tiles:1.0.0-alpha06
, androidx.wear.tiles:tiles-proto:1.0.0-alpha06
y androidx.wear.tiles:tiles-renderer:1.0.0-alpha06
. La versión 1.0.0-alpha06 contiene estas confirmaciones.
Cambios en la API
- Ahora, todas las clases de compiladores contienen métodos get para todas las propiedades. Ten en cuenta que solo se diseñaron con fin de ejecutar pruebas. (I9d155)
- Cambio de paquete: se movieron las clases en
androidx.wear.tiles.builders
aandroidx.wear.tiles
. - Se agregó compatibilidad con ajuste de tono experimental a las tarjetas. (I38929)
- Se cambió el nombre de
LayoutElementBuilders.HALIGN_*
porLayoutElementBuilders.HORIZONTAL_ALIGN_*
. (I67e58) - Se cambió el nombre de
LayoutElementBuilders.VALIGN_*
porLayoutElementBuilders.VERTICAL_ALIGN_*
. (I67e58) - Se cambió el nombre de
LayoutElementBuilders.SPAN_VALIGN_*
porLayoutElementBuilders.SPAN_VERTICAL_ALIGN_*
. (I67e58) - Se agregaron clases de compiladores para solicitudes y eventos. (Ib5cf4)
- Se migró
TileProviderService
para usar clases de solicitud y evento deRequestBuilders
yEventBuilders
, en lugar deRequestReaders
/EventReaders
. (p. ej.,onTileRequest
ahora brindaRequestBuilders.TileRequest
, en vez deRequestReaders.TileRequest
). (I46ea1)
Correcciones de errores
- Se corrigió el error en la carga asíncrona de imágenes para el procesador de tarjetas. (Iad9b0)
- Se corrigió el error de diseño que se producía cuando se colocaba una imagen con ancho o alto establecido en
expand()
, en un elementoBox
con ancho o alto configurado en un objetowrap()
. (I33770)
Versión 1.0.0-alpha05
18 de mayo de 2021
Se lanzaron androidx.wear.tiles:tiles:1.0.0-alpha05
, androidx.wear.tiles:tiles-proto:1.0.0-alpha05
y androidx.wear.tiles:tiles-renderer:1.0.0-alpha05
. La versión 1.0.0-alpha05 contiene estas confirmaciones.
Cambios en la API
- Se quitó getTileId de los eventos de tarjetas con contenido nuevo (
TileAddEvent
,TileRemoveEvent
,TileEnterEvent
,TileLeaveEvent
,TileRequest
). (Ifbba2). - Se cambió el nombre de
ImageResource#setAndroidResourceByResid
porsetAndroidResourceByResId
(I4ba6e) - Se cambió el nombre
TimelineManager#deInit
para cerrarlo y se implementóAutoCloseable
. (I5dff2).
Versión 1.0.0-alpha04
5 de mayo de 2021
Se lanzaron androidx.wear.tiles:tiles:1.0.0-alpha04
, androidx.wear.tiles:tiles-proto:1.0.0-alpha04
y androidx.wear.tiles:tiles-renderer:1.0.0-alpha04
. La versión 1.0.0-alpha04 contiene estas confirmaciones.
Cambios en la API
- Se ocultaron las clases concretas TileProviderService.
- TileUpdateRequester ahora toma una
Class<? extends TileProviderService>
. (Ib7cca).
- TileUpdateRequester ahora toma una
- Se agregó la capacidad de añadir elementos adicionales a AndroidActivity (I748f4).
Tiles versión 1.0.0-alpha03
21 de abril de 2021
Se lanzaron androidx.wear.tiles:tiles:1.0.0-alpha03
, androidx.wear.tiles:tiles-proto:1.0.0-alpha03
y androidx.wear.tiles:tiles-renderer:1.0.0-alpha03
. La versión 1.0.0-alpha03 contiene estas confirmaciones.
Cambios en la API
- Cambio de nombre:
TileManager
->TileClient
- Cambio de nombre:
TileManager#create
->TileClient#connect
(I91839)
- Cambio de nombre:
Correcciones de errores
- Se agregaron reglas de ProGuard para garantizar que
tiles
ytiles-renderer
funcionen de manera correcta cuando Proguard esté habilitado. (Ie3d85)
Versión 1.0.0-alpha02
7 de abril de 2021
Se lanzaron androidx.wear.tiles:tiles:1.0.0-alpha02
, androidx.wear.tiles:tiles-proto:1.0.0-alpha02
y androidx.wear.tiles:tiles-renderer:1.0.0-alpha02
. La versión 1.0.0-alpha02 contiene estas confirmaciones.
Cambios en la API
androidx.wear:wear-tiles
movió grupos y ahora debería llamarseandroidx.wear.tiles:tiles
.androidx.wear:wear-tiles-renderer
movió grupos y ahora debería llamarseandroidx.wear.tiles:tiles-renderer
.TileRenderer.LoadActionListener
ahora usa una instancia deandroidx.wear.tiles.builders.StateBuilders.State
en lugar deandroidx.wear.tiles.proto.StateProto.State
.TileRenderer
ahora acepta recursos de tarjetas deandroidx.wear.tiles.builders.ResourceBuilders.Resources
, en lugar de una instancia deandroidx.wear.tiles.renderer.ResourceAccessors
.
Correcciones de errores
- Se corrigió la incapacidad para usar
LoadActionListener
, ya que exponía una clase interna.
Versión 1.0.0-alpha01
10 de marzo de 2021
Se lanzaron androidx.wear:wear-tiles:1.0.0-alpha01
, androidx.wear:wear-tiles-proto:1.0.0-alpha01
y androidx.wear:wear-tiles-renderer:1.0.0-alpha01
. La versión 1.0.0-alpha01 contiene estas confirmaciones.
Nuevas funciones
- La biblioteca del procesador de las Tarjetas de Wear proporciona funcionalidad a fin de crear tarjetas personalizadas para dispositivos Wear OS, junto con las clases que permiten que el sistema recupere tu tarjeta y la muestre junto a la cara de reloj.