Migrer vers les espaces de noms ProtoLayout

Depuis la version 1.2, la plupart des API de mise en page de cartes se trouvent dans l'espace de noms androidx.wear.protolayout. Pour utiliser les dernières API, suivez la procédure de migration suivante dans votre code.

Mettre à jour les dépendances

Dans le fichier de compilation de votre module d'application, apportez les modifications suivantes :

Groovy

  // 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"

Kotlin

  // 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")

Mettre à jour les espaces de noms

Dans les fichiers de code basés sur Kotlin et Java de votre application, effectuez les mises à jour suivantes. Vous pouvez également exécuter ce script de modification du nom d'un espace de noms.

  1. Remplacez toutes les importations androidx.wear.tiles.material.* par androidx.wear.protolayout.material.*. Effectuez également cette étape pour la bibliothèque androidx.wear.tiles.material.layouts.

  2. Remplacez la plupart des autres importations androidx.wear.tiles.* par androidx.wear.protolayout.*.

    Les importations pour androidx.wear.tiles.EventBuilders, androidx.wear.tiles.RequestBuilders, androidx.wear.tiles.TileBuilders et androidx.wear.tiles.TileService ne doivent pas changer.

  3. Renommez quelques méthodes obsolètes des classes TileService et TileBuilder :

    1. TileBuilders : getTimeline() en getTileTimeline(), et setTimeline() en setTileTimeline()
    2. TileService : onResourcesRequest() en onTileResourcesRequest()
    3. RequestBuilders.TileRequest : getDeviceParameters() en getDeviceConfiguration(), setDeviceParameters() en setDeviceConfiguration(), getState() en getCurrentState(), et setState() en setCurrentState()