Bermigrasi ke namespace ProtoLayout

Mulai versi 1.2, sebagian besar API tata letak Kartu berada di namespace androidx.wear.protolayout. Untuk menggunakan API terbaru, selesaikan langkah-langkah migrasi berikut dalam kode Anda.

Memperbarui dependensi

Dalam file build modul aplikasi Anda, buat perubahan berikut:

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

Memperbarui namespace

Di file kode berbasis Kotlin dan Java aplikasi Anda, lakukan pembaruan berikut. Bisa juga dengan mengeksekusi skrip penggantian nama namespace ini.

1. Ganti semua impor androidx.wear.tiles.material.* dengan androidx.wear.protolayout.material.*. Selesaikan juga langkah ini untuk library androidx.wear.tiles.material.layouts.

2. Ganti sebagian besar impor androidx.wear.tiles.* lainnya dengan androidx.wear.protolayout.*.

   Impor untuk androidx.wear.tiles.EventBuilders, androidx.wear.tiles.RequestBuilders, androidx.wear.tiles.TileBuilders, dan androidx.wear.tiles.TileService harus tetap sama.

3. Ganti nama beberapa metode yang tidak digunakan lagi dari class TileService dan TileBuilder:

   1. TileBuilders: getTimeline() ke getTileTimeline(), dan setTimeline() ke setTileTimeline()
   2. TileService: onResourcesRequest() ke onTileResourcesRequest()
   3. RequestBuilders.TileRequest: getDeviceParameters() ke getDeviceConfiguration(), setDeviceParameters() ke setDeviceConfiguration(), getState() ke getCurrentState(), dan setState() ke setCurrentState()
   Catatan: Mulai library versi 1.2, ada metode getState() dan setState() di class TileBuilders, dan merupakan metode yang tepat untuk digunakan. Kedua metode ini berbeda dengan metode RequestBuilders.getState() dan RequestBuilders.setState().