遷移至 ProtoLayout 命名空間

自 1.2 版起，大多數的資訊方塊版面配置 API 都位於 androidx.wear.protolayout 命名空間中。如要使用最新的 API，請完成下列程式碼遷移步驟。

更新依附元件

在應用程式模組的建構檔案中進行下列變更：

Groovy

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

更新命名空間

在應用程式的 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() 方法不同。