Tarjetas de Wear

Crea aplicaciones para relojes inteligentes de Wear OS by Google.
Actualización más reciente Versión estable Versión potencial Versión beta Versión alfa
4 de junio de 2025 1.5.0 - - -

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"

    // Use to utilize standard components and layouts in your tiles
    implementation "androidx.wear.protolayout:protolayout:1.3.0"

    // Use to utilize components and layouts with Material Design in your tiles
    implementation "androidx.wear.protolayout:protolayout-material:1.3.0"

    // Use to include dynamic expressions in your tiles
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0"

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.5.0"

    // Use to fetch tiles from a tile provider in your tests
    testImplementation "androidx.wear.tiles:tiles-testing:1.5.0"
}

Kotlin

dependencies {
    // Use to implement support for wear tiles
    implementation("androidx.wear.tiles:tiles:1.5.0")

    // Use to utilize standard components and layouts in your tiles
    implementation("androidx.wear.protolayout:protolayout:1.3.0")

    // Use to utilize components and layouts with Material Design in your tiles
    implementation("androidx.wear.protolayout:protolayout-material:1.3.0")

    // Use to include dynamic expressions in your tiles
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0")

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.5.0")

    // Use to fetch tiles from a tile provider in your tests
    testImplementation("androidx.wear.tiles:tiles-testing:1.5.0")
}

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.5

Versión 1.5.0

4 de junio de 2025

Lanzamiento de androidx.wear.tiles:tiles-*:1.5.0. La versión 1.5.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.4.0

  • Se agregó una nueva API TileService.onRecentInteractionEvents() para procesar eventos de tarjetas de interacción (Entrar / Salir) en lotes.
    • Las APIs existentes en TileService para onEnterEvent y onLeaveEvent dejaron de estar disponibles y no funcionarán a partir del SDK 36 en el caso de las apps que se segmenten para el nivel de API 36 o versiones posteriores.
  • Se corrigió un error crítico para los clientes que se orientan a un SDK superior al 34 y que solicitan una actualización de tarjetas en la API 34 que causaría un SecurityException.
  • A partir de Wear 6 (nivel de SDK 36 y versiones posteriores), todas las tarjetas se mostrarán en una fuente del sistema que define cada dispositivo.

Versión 1.5.0-rc01

20 de mayo de 2025

Se lanzó androidx.wear.tiles:tiles-*:1.5.0-rc01 sin cambios desde la versión anterior. La versión 1.5.0-rc01 contiene estas confirmaciones.

Versión 1.5.0-beta02

7 de mayo de 2025

Lanzamiento de androidx.wear.tiles:tiles-*:1.5.0-beta02. La versión 1.5.0-beta02 contiene estas confirmaciones.

Versión 1.5.0-beta01

9 de abril de 2025

Lanzamiento de androidx.wear.tiles:tiles-*:1.5.0-beta01. La versión 1.5.0-beta01 contiene estas confirmaciones.

Nuevas funciones

La versión 1.5.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.5 incluye las siguientes APIs y funciones nuevas:

  • Se agregó una nueva API TileService.onRecentInteractionEvents() para procesar eventos de tarjetas de interacción (Entrar / Salir) en lotes.
    • Las APIs existentes en TileService para onEnterEvent y onLeaveEvent dejaron de estar disponibles y no funcionarán a partir del SDK 36 en el caso de las apps que se segmenten para el nivel de API 36 o versiones posteriores.
  • Se corrigió un error crítico para los clientes que se orientan a un SDK superior al 34 y que solicitan una actualización de tarjetas en la API 34 que causaría un SecurityException.
  • A partir de Wear 6 (nivel de SDK 36 y versiones posteriores), todas las tarjetas se mostrarán en una fuente del sistema que define cada dispositivo.

Versión 1.5.0-alpha10

12 de marzo de 2025

Lanzamiento de androidx.wear.tiles:tiles-*:1.5.0-alpha10. La versión 1.5.0-alpha10 contiene estas confirmaciones.

Versión 1.5.0-alpha09

26 de febrero de 2025

Lanzamiento de androidx.wear.tiles:tiles-*:1.5.0-alpha09. La versión 1.5.0-alpha09 contiene estas confirmaciones.

Versión 1.5.0-alpha08

12 de febrero de 2025

Lanzamiento de androidx.wear.tiles:tiles-*:1.5.0-alpha08. La versión 1.5.0-alpha08 contiene estas confirmaciones.

Cambios en la API

  • TileService.onRecentInteractionEvents() para mostrar ListenableFuture<Void> y permitir tareas de larga duración. (Iaa6c5).

Versión 1.5.0-alpha07

29 de enero de 2025

Lanzamiento de androidx.wear.tiles:tiles-*:1.5.0-alpha07. La versión 1.5.0-alpha07 contiene estas confirmaciones.

Versión 1.5.0-alpha06

15 de enero de 2025

Lanzamiento de androidx.wear.tiles:tiles-*:1.5.0-alpha06. La versión 1.5.0-alpha06 contiene estas confirmaciones.

Cambios en la API

  • Se cambió el nombre de processRecentInteractionEvents por onRecentInteractionEvents. (Iec3d5).

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 el siguiente argumento del compilador para aplicar el uso correcto: -Xjspecify-annotations=strict (este es el valor predeterminado a partir de la versión 2.1.0 del compilador de Kotlin). (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 un SecurityException (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 de WearSdk (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 y TileLeave, 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 objeto TileRenderer.Config. (Ib66f9).
  • Agrega un atributo platformDataProviders a TileRenderer.Config. (I6030d).
  • Se agregó un nuevo constructor a TileRenderer que admite una nueva clase TileRenderer.Config. Otros constructores dejaron de estar disponibles. (Iae7ff).
  • Agrega un campo platformDataValues a TilePreviewData 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

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 a getActiveTilesAsync. (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 para las herramientas de tarjetas de 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 para las herramientas de tarjetas de 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 de ProtoLayout 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 por DynamicDataValue y se actualizaron las APIs de estado para usar DynamicDataKey (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 de StateStore. Como resultado, el desarrollador debe asegurarse de no tener más de MAX_STATE_ENTRY_COUNT entradas en el mapa; de lo contrario, recibirá un IllegalStateException cuando cree o actualice el StateStore. (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 un ListenableFuture. (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 de implementation 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 a TileRenderer (I4ac7f).
  • El nombre de ObservableStateStore cambió por StateStore. (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 a TileService para proporcionar recursos de la biblioteca protolayout. (983d9c5).
  • Actualizamos ResourcesRequest y TileRequest para admitir los tipos State y DeviceParameters de la biblioteca protolayout. (88fa01d).
  • Actualizamos TileBuilders.Tile para admitir los tipos State y Timeline de la biblioteca protolayout. (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 y Text. 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 y MultiSlotLayout. 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 y TitleChip: 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 objeto MultiSlotLayout o MultiButtonLayout.
  • EdgeContentLayout: Es un diseño para alojar CircularProgressIndicator 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 por EdgeContentLayout (Ic1aa6).
  • Se cambió el nombre del contenido del tamaño del botón por el sufijo without _BUTTON con aclaraciones adicionales de Javadocs en Button (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 aceptan ElementMetadata 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 en PrimaryLayout, 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 y PrimaryLayout. 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 de iconTintColor a iconColor (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 elemento PrimaryLayout 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 y TitleChip que no tienen métodos set que coincidan (I99e85).
  • Se quitó DEFAULT_PADDING de ProgressIndicatorDefaults (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 a Chip (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 en TileUiClient 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 a new Foo.Builder(), y se quitaron las sobrecargas de método set que aceptaban una instancia de Builder (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.
  • Se agregó documentación para DefaultTileProviderClient y TestingTileProviderClient 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 expone DefaultTileProviderClient, lo que permite que las implementaciones se vinculen a una interfaz TileProviderService. (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 a androidx.wear.tiles.
  • Se agregó compatibilidad con ajuste de tono experimental a las tarjetas. (I38929)
  • Se cambió el nombre de LayoutElementBuilders.HALIGN_* por LayoutElementBuilders.HORIZONTAL_ALIGN_*. (I67e58)
  • Se cambió el nombre de LayoutElementBuilders.VALIGN_* por LayoutElementBuilders.VERTICAL_ALIGN_*. (I67e58)
  • Se cambió el nombre de LayoutElementBuilders.SPAN_VALIGN_* por LayoutElementBuilders.SPAN_VERTICAL_ALIGN_*. (I67e58)
  • Se agregaron clases de compiladores para solicitudes y eventos. (Ib5cf4)
  • Se migró TileProviderService para usar clases de solicitud y evento de RequestBuilders y EventBuilders, en lugar de RequestReaders/EventReaders. (p. ej., onTileRequest ahora brinda RequestBuilders.TileRequest, en vez de RequestReaders.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 elemento Box con ancho o alto configurado en un objeto wrap(). (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 por setAndroidResourceByResId (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).
  • 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)

Correcciones de errores

  • Se agregaron reglas de ProGuard para garantizar que tiles y tiles-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 llamarse androidx.wear.tiles:tiles.
  • androidx.wear:wear-tiles-renderer movió grupos y ahora debería llamarse androidx.wear.tiles:tiles-renderer.
  • TileRenderer.LoadActionListener ahora usa una instancia de androidx.wear.tiles.builders.StateBuilders.State en lugar de androidx.wear.tiles.proto.StateProto.State.
  • TileRenderer ahora acepta recursos de tarjetas de androidx.wear.tiles.builders.ResourceBuilders.Resources, en lugar de una instancia de androidx.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.