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
18 de mayo de 2022 1.0.1 - - 1.1.0-alpha07

Cómo declarar dependencias

Para agregar una dependencia en Wear, debes agregar el repositorio Maven de Google a tu proyecto. Consulta el repositorio 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.1.0-alpha08"

    // Use to utilize components and layouts with Material design in your tiles
    implementation "androidx.wear.tiles:tiles-material:1.1.0-alpha08"

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

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

Kotlin

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

    // Use to utilize components and layouts with Material design in your tiles
    implementation("androidx.wear.tiles:tiles-material:1.1.0-alpha08")

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

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

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 en esta biblioteca antes de crear uno nuevo. Para agregar tu voto a un error existente, haz clic en el botón de la estrella.

Cómo crear un error nuevo

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

Versión 1.1

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

Lanzamiento de 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 pasa al constructor. Ahora se puede personalizar este componente mediante 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

Lanzamiento de 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. (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 el material de tarjetas 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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

Lanzamiento de 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.