Zu ProtoLayout-Namespaces migrieren

Ab Version 1.2 befinden sich die meisten Tiles Layout APIs in der androidx.wear.protolayout -Namespace auf sie zugegriffen werden. Führen Sie die folgenden Migrationsschritte aus, um die neuesten APIs zu verwenden: Ihren Code.

Abhängigkeiten aktualisieren

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

Cool

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

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

  // Update
  implementation "androidx.wear.tiles:tiles:1.4.0"

Kotlin

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

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

  // Update
  implementation("androidx.wear.tiles:tiles:1.4.0")

Namespaces aktualisieren

Nehmen Sie in den Kotlin- und Java-basierten Codedateien Ihrer App die folgenden Aktualisierungen vor. Alternativ können Sie dieses Skript zur Umbenennung von Namespace ausführen.

  1. Alle androidx.wear.tiles.material.* Importe ersetzen durch androidx.wear.protolayout.material.*. Führen Sie diesen Schritt für den androidx.wear.tiles.material.layouts auch.
  2. Die meisten anderen androidx.wear.tiles.*-Importe ersetzen 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 gleich bleiben.

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

    1. TileBuilders: getTimeline() in 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()