Cómo migrar a espacios de nombres de ProtoLayout

A partir de la versión 1.2, la mayoría de las APIs de diseño de tarjetas está en el espacio de nombres androidx.wear.protolayout. Para usar las APIs más recientes, completa los siguientes pasos de migración en tu código.

Actualiza las dependencias

En el archivo de compilación del módulo de tu app, realiza los siguientes cambios:

GroovyKotlin

  // Remove
  implementation 'androidx.wear.tiles:tiles-material:version'

  // Include additional dependencies
  implementation "androidx.wear.protolayout:protolayout:1.3.0-alpha03"
  implementation "androidx.wear.protolayout:protolayout-material:1.3.0-alpha03"
  implementation "androidx.wear.protolayout:protolayout-expression:1.3.0-alpha03"

  // Update
  implementation "androidx.wear.tiles:tiles:1.5.0-alpha03"

  // Remove
  implementation("androidx.wear.tiles:tiles-material:version")

  // Include additional dependencies
  implementation("androidx.wear.protolayout:protolayout:1.3.0-alpha03")
  implementation("androidx.wear.protolayout:protolayout-material:1.3.0-alpha03")
  implementation("androidx.wear.protolayout:protolayout-expression:1.3.0-alpha03")

  // Update
  implementation("androidx.wear.tiles:tiles:1.5.0-alpha03")

Actualiza los espacios de nombres

En los archivos de código basados en Kotlin y Java de tu app, realiza las siguientes actualizaciones. También puedes ejecutar esta secuencia de comandos de cambio de nombres de los espacios de nombres.

1. Reemplaza todas las importaciones de androidx.wear.tiles.material.* por androidx.wear.protolayout.material.*. Realiza también este paso para la biblioteca androidx.wear.tiles.material.layouts.

2. Reemplaza la mayoría de las demás importaciones de androidx.wear.tiles.* por androidx.wear.protolayout.*.

   Las importaciones de androidx.wear.tiles.EventBuilders, androidx.wear.tiles.RequestBuilders, androidx.wear.tiles.TileBuilders y androidx.wear.tiles.TileService deben permanecer iguales.

3. Cambia el nombre de algunos métodos obsoletos de las clases TileService y TileBuilder:

   1. TileBuilders: getTimeline() por getTileTimeline() y setTimeline() por setTileTimeline()
   2. TileService: onResourcesRequest() por onTileResourcesRequest()
   3. RequestBuilders.TileRequest: getDeviceParameters() por getDeviceConfiguration(), setDeviceParameters() por setDeviceConfiguration(), getState() por getCurrentState() y setState() por setCurrentState()
   Nota: A partir de la versión 1.2 de la biblioteca, existen los métodos getState() y setState() en la clase TileBuilders, los cuales son los correctos para usar. Son diferentes a los métodos RequestBuilders.getState() y RequestBuilders.setState().