ProtoLayout 名前空間に移行する

バージョン 1.2 ではタイル レイアウト API のほとんどは androidx.wear.protolayout 名前空間にあります。最新の API を使用するには、コードで以下の移行手順を実行してください。

依存関係を更新する

アプリ モジュールのビルドファイルを次のように変更します。

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

名前空間を更新する

アプリの Kotlin ベースと Java ベースのコードファイルを次のように更新します。または、こちらの名前空間名変更スクリプトを実行することもできます。

1. すべての androidx.wear.tiles.material.* インポートを androidx.wear.protolayout.material.* に置き換えます。androidx.wear.tiles.material.layouts ライブラリでもこのステップを実行します。

2. 他の androidx.wear.tiles.* インポートのほとんどを androidx.wear.protolayout.* に置き換えます。

   androidx.wear.tiles.EventBuilders、androidx.wear.tiles.RequestBuilders、androidx.wear.tiles.TileBuilders、androidx.wear.tiles.TileService のインポートはそのままにします。

3. TileService クラスと TileBuilder クラスの非推奨のメソッドの名前を変更します。

   1. TileBuilders: getTimeline() から getTileTimeline()、setTimeline() から setTileTimeline() に変更
   2. TileService: onResourcesRequest() から onTileResourcesRequest() に変更
   3. RequestBuilders.TileRequest: getDeviceParameters() から getDeviceConfiguration()、setDeviceParameters() から setDeviceConfiguration()、getState() から getCurrentState()、setState() から setCurrentState() に変更
   注: バージョン 1.2 以降のライブラリには、TileBuilders クラスに getState() メソッドと setState() メソッドがあり、それらは使用できる適切なメソッドです。これらのメソッドは RequestBuilders.getState() メソッドおよび RequestBuilders.setState() メソッドとは異なります。