Zu ProtoLayout-Namespaces migrieren

Ab Version 1.2 befinden sich die meisten APIs für das Layout von Ansichten im Namespace androidx.wear.protolayout. Wenn Sie die neuesten APIs verwenden möchten, führen Sie die folgenden Migrationsschritte in Ihrem Code aus.

Abhängigkeiten aktualisieren

Nehmen Sie in der Build-Datei Ihres App-Moduls die folgenden Änderungen vor:

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

Namespaces aktualisieren

Nehmen Sie in den Kotlin- und Java-basierten Codedateien Ihrer App die folgenden Aktualisierungen vor. Alternativ können Sie dieses Script zum Umbenennen von Namespaces ausführen.

1. Ersetzen Sie alle androidx.wear.tiles.material.*-Importe durch androidx.wear.protolayout.material.*. Führen Sie diesen Schritt auch für die Bibliothek androidx.wear.tiles.material.layouts aus.

2. Ersetzen Sie die meisten anderen androidx.wear.tiles.*-Importe durch androidx.wear.protolayout.*.

   Importe für androidx.wear.tiles.EventBuilders, androidx.wear.tiles.RequestBuilders, androidx.wear.tiles.TileBuilders und androidx.wear.tiles.TileService sollten unverändert bleiben.

3. Benennen Sie einige veraltete Methoden der TileService- und TileBuilder-Klassen um:

   1. TileBuilders: getTimeline() bis getTileTimeline() und setTimeline() bis setTileTimeline()
   2. TileService – alter Preis: onResourcesRequest(), neuer Preis: onTileResourcesRequest()
   3. RequestBuilders.TileRequest: getDeviceParameters() bis getDeviceConfiguration(), setDeviceParameters() bis setDeviceConfiguration(), getState() bis getCurrentState() und setState() bis setCurrentState()