Tarjetas de Wear
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.
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
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
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
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
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
aChip
(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
enTileUiClient
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 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
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
.
- 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
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 exponeDefaultTileProviderClient
, lo que permite que las implementaciones se vinculen a una interfazTileProviderService
. (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
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
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
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
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).
- 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
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)
- 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
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 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
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.