העברה למרחבי שמות של ProtoLayout

החל מגרסה 1.2, רוב ממשקי ה-API של פריסת המשבצות נמצאים במרחב השמות androidx.wear.protolayout. כדי להשתמש בממשקי ה-API העדכניים ביותר, תצטרכו להשלים את שלבי ההעברה הבאים בקוד.

עדכון יחסי התלות

בקובץ ה-build של מודול האפליקציה, מבצעים את השינויים הבאים:

Groovy

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

  // 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 של הספרייה, יש שיטות getState() ו-setState() בכיתה TileBuilders, ואלה השיטות הנכונות לשימוש. הן שונות מהשיטות RequestBuilders.getState() ו-RequestBuilders.setState().