Wear Tiles

建立 Wear OS by Google 智慧型手錶的應用程式。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2024 年 8 月 7 日 1.4.0 - - -

宣告依附元件

如要為 Wear 新增依附元件,您必須將 Google Maven 存放區新增至專案。詳情請參閱「Google 的 Maven 存放區」一節。

在應用程式或模組的 build.gradle 檔案中,新增所需構件的依附元件:

Groovy

dependencies {
    // Use to implement support for wear tiles
    implementation "androidx.wear.tiles:tiles:1.4.0"

    // Use to utilize standard components and layouts in your tiles
    implementation "androidx.wear.protolayout:protolayout:1.2.0"

    // Use to utilize components and layouts with Material Design in your tiles
    implementation "androidx.wear.protolayout:protolayout-material:1.2.0"

    // Use to include dynamic expressions in your tiles
    implementation "androidx.wear.protolayout:protolayout-expression:1.2.0"

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.4.0"

    // Use to fetch tiles from a tile provider in your tests
    testImplementation "androidx.wear.tiles:tiles-testing:1.4.0"
}

Kotlin

dependencies {
    // Use to implement support for wear tiles
    implementation("androidx.wear.tiles:tiles:1.4.0")

    // Use to utilize standard components and layouts in your tiles
    implementation("androidx.wear.protolayout:protolayout:1.2.0")

    // Use to utilize components and layouts with Material Design in your tiles
    implementation("androidx.wear.protolayout:protolayout-material:1.2.0")

    // Use to include dynamic expressions in your tiles
    implementation("androidx.wear.protolayout:protolayout-expression:1.2.0")

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.4.0")

    // Use to fetch tiles from a tile provider in your tests
    testImplementation("androidx.wear.tiles:tiles-testing:1.4.0")
}

如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件

1.4 版

1.4.0 版本

2024 年 8 月 7 日

發布 androidx.wear.tiles:tiles-*:1.4.0。1.4.0 版包含這些修訂版本

自 1.3.0 版以來的重要異動

  • 支援在 Android Studio 中為資訊方塊預覽指定自訂平台資料的工具。

1.4.0-rc01 版本

2024 年 7 月 24 日

發布了 androidx.wear.tiles:tiles-*:1.4.0-rc01,且與先前版本沒有差別。1.4.0-rc01 版包含這些修訂版本

1.4.0-beta01 版本

2024 年 7 月 10 日

發布 androidx.wear.tiles:tiles-*:1.4.0-beta01。1.4.0-beta01 版包含這些修訂版本

新功能

Wear Tiles 的 1.4.0-beta01 版表示該程式庫版本功能完整,且 API 已鎖定 (除非標示為實驗功能)。Wear Tiles 1.4 提供下列新功能和 API:

  • 支援在 Android Studio 中為資訊方塊預覽指定自訂平台資料的工具。

1.4.0-alpha05 版

2024 年 6 月 26 日

發布 androidx.wear.tiles:tiles-*:1.4.0-alpha05。1.4.0-alpha05 版包含這些修訂版本

1.4.0-alpha04 版本

2024 年 5 月 29 日

發布 androidx.wear.tiles:tiles-*:1.4.0-alpha04。1.4.0-alpha04 版包含這些修訂版本

1.4.0-alpha03 版

2024 年 5 月 14 日

發布 androidx.wear.tiles:tiles-*:1.4.0-alpha03。1.4.0-alpha03 版包含這些修訂版本

修正錯誤

  • TileService#getActiveTilesAsync 現在會使用 WearSdk API (如果有的話) 來提供更準確的結果。(I57bd8)。

1.4.0-alpha02 版

2024 年 5 月 1 日

發布 androidx.wear.tiles:tiles-*:1.4.0-alpha02。1.4.0-alpha02 版包含這些修訂版本

API 變更

  • tileId 移至 Builder 建構函式參數,做為必要欄位,並在 getter 中記錄預設時間戳記值。(I98c2b)。
  • 新增 TileInteractionEventTileEnterTileLeave proto 訊息,以及批次處理資訊方塊進入/離開事件所需的 Java 包裝函式。(I112b0)。
  • 重構 TileRenderer,使用 Builder 而非 TileRenderer.Config 物件。(Ib66f9)。
  • TileRenderer.Config 中加入 platformDataProviders 屬性。(I6030d)。
  • TileRenderer 中新增支援新 TileRenderer.Config 類別的建構函式。已淘汰其他建構函式。(Iae7ff)。
  • TilePreviewData 中新增 platformDataValues 欄位,允許覆寫平台資料值。(If437a)。

修正錯誤

  • 說明 TileRenderer.Config.Builder#setTilesTheme 的預設值為零。(Iced18)。

1.4.0-alpha01 版

2024 年 3 月 6 日

發布 androidx.wear.tiles:tiles-*:1.4.0-alpha01。1.4.0-alpha01 版包含這些修訂版本

1.3 版本

1.3.0 版本

2024 年 2 月 7 日

發布 androidx.wear.tiles:tiles-*:1.3.01.3.0 版包含此連結所列的修訂項目。

自 1.2.0 版以來的重要異動

  • 更新了資訊方塊預覽支援的工具。
  • 支援查詢屬於應用程式的使用中資訊方塊。

其他變更

1.3.0-rc01 版本

2024 年 1 月 24 日

發布 androidx.wear.tiles:tiles-*:1.3.0-rc01查看 1.3.0-rc01 版的修訂項目

API 變更

  • TileService#getActiveTilesSnapshotAsync 已重新命名為 getActiveTilesAsync。(If6b87)。

1.3.0-beta01 版本

2024 年 1 月 10 日

發布 androidx.wear.tiles:tiles-*:1.3.0-beta01查看 1.3.0-beta01 版的修訂項

Wear Tiles 的 1.3.0-beta01 版表示該程式庫功能完整,且 API 已鎖定 (除非標示為實驗功能)。Wear Tiles 1.3 提供下列新功能和 API:

  • Wear 圖塊工具的模組已更新,支援資訊方塊預覽功能,並設為發布。
  • 支援使用 TileService.getActiveTilesSnapshotAsync 查詢屬於應用程式的資訊方塊。

1.3.0-alpha04 版本

2023 年 12 月 13 日

發布 androidx.wear.tiles:tiles-*:1.3.0-alpha041.3.0-alpha04 版包含此連結所列的修訂項目

1.3.0-alpha03 版

2023 年 11 月 29 日

發布 androidx.wear.tiles:tiles-*:1.3.0-alpha031.3.0-alpha03 版包含此連結所列的修訂項目

新功能

  • 新增了 API TileService#getActiveTilesSnapshotAsync,以便查詢屬於該應用程式的資訊方塊。(I6850e)。

API 變更

  • @TilePreview 重新命名為 @Preview (Ifc08a)

1.3.0-alpha02 版本

2023 年 11 月 15 日

發布 androidx.wear.tiles:tiles-*:1.3.0-alpha02查看 1.3.0-alpha02 版的修訂項

新功能

  • 我們新增了實驗性 API,可根據父項內部的空間自動調整文字大小。(Ibbe63)。

1.3.0-alpha01 版本

2023 年 10 月 18 日

發布 androidx.wear.tiles:tiles-*:1.3.0-alpha011.3.0-alpha01 版包含此連結所列的修訂項目。

新功能

  • 請將內容做為預覽方法參數提供,而非 TilePreviewData 回呼參數。(I5e97d)。
  • Wear 圖塊工具的模組已更新,支援資訊方塊預覽功能,並設為發布。(I63d0f)。

1.2 版本

1.2.0 版本

2023 年 8 月 9 日

發布 androidx.wear.tiles:tiles-*:1.2.01.2.0 版包含此連結所列的修訂項目。

自 1.1.0 版以來的重要異動

  • Wear Tiles 1.2.0 的穩定版 (瞭解詳情)
  • 資訊方塊 1.2 新增了對版面配置元素繫結至平台資料的支援 (以便加快更新速度) 和動畫。如需遷移操作說明,請參閱 (1.2.0-rc01) 的版本資訊

1.2.0-rc01 版本

2023 年 7 月 26 日

發布 androidx.wear.tiles:tiles-*:1.2.0-rc01查看 1.2.0-rc01 版的修訂項目

  • 我們在 1.2 版中重構了 Tiles 程式庫,並將大部分功能和 API 都移至新的 ProtoLayout 程式庫 (套件 androidx.wear.protolayout),並在資訊方塊 (androidx.wear.tiles) 中保留一小部分:

    • 所有類別的名稱都維持不變,只有 v1.1 才新增名稱
    • 大多數 API 都維持不變,唯一的變更是套件名稱。
    • TileService/TileBuilder 中的某些方法已淘汰,現在重新命名版本,可接受新的 ProtoLayout 類型,而非已淘汰的 Tiles 類型。
  • 為簡化遷移程序,我們整理了一份小操作說明和指令碼,以執行這項重新命名作業,請參閱這個網頁

API 變更

  • 我們限制了版面配置在圖塊中最多只能包含 30 個巢狀元素的深度。如果超過該深度,資訊方塊轉譯器會顯示先前加載的版面配置。(I8a74b)。

1.2.0-beta01 版本

2023 年 6 月 21 日

androidx.wear.tiles:tiles-*:1.2.0-beta01 發布,內容無變更。查看 1.2.0-beta01 版的修訂項

1.2.0-alpha07 版

2023 年 6 月 7 日

發布 androidx.wear.tiles:tiles-*:1.2.0-alpha07查看 1.2.0-alpha07 版的修訂項

新功能

  • TileRenderer.setState 允許設定轉譯工作階段的狀態。這個狀態將套用至目前的版面配置和任何未來的版面配置,直到新狀態設定為止 (Iaaf35)
  • 所有 Tile-renderer APIS 皆已完整支援 protolayout 類型。(I428b0)。

修正錯誤

  • 現可在 ProtoLayoutViewInstance 中設定自訂主題。(Iae8c0)。

1.2.0-alpha06 版本

2023 年 5 月 24 日

發布 androidx.wear.tiles:tiles-*:1.2.0-alpha06查看 1.2.0-alpha06 版的修訂項目

API 變更

  • StateEntryValue 重新命名為 DynamicDataValue,並將狀態 API 更新為使用 DynamicDataKey (If1c01)
  • 我們限制了 StateStore 允許的項目數量,確保能妥善控管及控管 StateStore 中每個執行個體的記憶體用量和狀態更新時間。因此,開發人員必須確保地圖中的項目不會超過 MAX_STATE_ENTRY_COUNT 項目,否則在建立或更新 StateStore 時會看到 IllegalStateException。(Ibadb3)。

1.2.0-alpha05 版本

2023 年 5 月 10 日

發布 androidx.wear.tiles:tiles-*:1.2.0-alpha05查看 1.2.0-alpha05 版的修訂項

新功能

  • 我們已在資訊方塊事件和要求中新增圖塊 ID。這個 ID 可用於將部分資料與輪轉介面中的資訊方塊例項建立關聯。(Ic4f83)。

API 變更

  • TileRenderer.inflateAsync 現在會傳回 ListenableFuture。(I2f2b9)。
  • protolayout 程式庫中有替代項目的資訊方塊建構工具現已標示為已淘汰。(Ie2029)。

修正錯誤

  • TileService.onTileResourcesRequest 的 javadoc 現在可明確指出系統何時可能呼叫這個方法。(Iee037)。

1.2.0-alpha04 版本

2023 年 4 月 19 日

發布 androidx.wear.tiles:tiles-*:1.2.0-alpha04查看 1.2.0-alpha04 版的修訂項

修正錯誤

  • Gradle 依附元件現在會於必要時正確地設為 api,而非 implementation。(I40503)。

1.2.0-alpha03 版本

2023 年 4 月 5 日

發布 androidx.wear.tiles:tiles-*:1.2.0-alpha03查看 1.2.0-alpha03 版的修訂項

API 變更

  • 我們已在 TileRenderer 中新增對 androidx.wear.protolayout 類型的支援 (I4ac7f)
  • ObservableStateStore」已重新命名為「StateStore」。(Ieb0e2)。
  • 將 protolayout 類型的超載新增至 TileRenderer (I4ac7f)
  • TileRenderer 中啟用動畫 (I07dcf)

1.2.0-alpha02 版本

2023 年 3 月 22 日

發布 androidx.wear.tiles:tiles-*:1.2.0-alpha021.2.0-alpha02 版包含此連結所列的修訂項目。

API 變更

  • 已淘汰 Tiles Material 程式庫。請使用具備相同功能的新 ProtoLayout Material 程式庫。(If242b)。

修正錯誤

  • TileRenderer 已更新,以使用 protolayout 程式庫的新功能。(I832f9)。

1.2.0-alpha01 版本

2023 年 3 月 8 日

發布 androidx.wear.tiles:tiles-*:1.2.0-alpha011.2.0-alpha01 版包含此連結所列的修訂項目。

新功能

  • 我們已將 onTileResourceRequest 新增至 TileService,以便提供 protolayout 程式庫的資源。(983d9c5)。
  • 我們已更新 ResourcesRequestTileRequest,以便支援 protolayout 程式庫中的 StateDeviceParameters 類型。(88fa01d)。
  • 我們已更新 TileBuilders.Tile,以支援 protolayout 程式庫中的 StateTimeline 類型。(168619c)。

修正錯誤

  • 改善 Javadocs。(I3ed73)。
  • onPrimary 和表面的預設顏色已變更。(I0b039)。

1.1 版本

1.1.0 版本

2022 年 8 月 24 日

發布 androidx.wear.tiles:tiles-*:1.1.0查看 1.1.0 版的修訂項

自 1.0.0 版以來的重要變更

  • 這是包含 Tiles Material 程式庫的第一個穩定版本 (詳情請參閱我們的網誌)。
  • 這個程式庫包含符合 Material 指南且易於使用的元件和版面配置。包含的元件包括 ButtonChipCompactChipTitleChipCircularProgressIndicatorText。所有這些元件都有各自的顏色物件,可使用主要顏色類別建構,輕鬆對所有元件套用相同的主題。除了顏色以外,您也可以使用字體排版名稱,輕鬆取得 FontStyle 物件。
  • 除了元件之外,還有建議的圖塊版面配置:PrimaryLayoutEdgeContentLayoutMultiButtonLayoutMultiSlotLayout。所有版面配置均套用了符合 Material 指南建議的邊框間距和樣式。
  • 如需 Tiles Material 程式庫中的元件和版面配置清單,請參閱資訊方塊的版本資訊。

1.1.0-rc01 版本

2022 年 8 月 10 日

發布 androidx.wear.tiles:tiles-*:1.1.0-rc011.1.0-rc01 版包含此連結所列的修訂項目。

  • Beta 版和 RC 版沒有新的異動。

1.1.0-beta01 版本

2022 年 7 月 27 日

發布 androidx.wear.tiles:tiles-*:1.1.0-beta011.1.0-beta01 版包含此連結所列的修訂項目。

Tiles Material 程式庫的 1.0.0-beta01 版本包含符合 Material Design 指南且易於建構的元件和版面配置。

包含的元件如下:

  • Button - 可點擊的圓形物件,包含具有 3 個預先定義大小的圖示、文字或圖片。
  • Chip - 可點擊的體育場形物件,可包含圖示、主要和次要標籤,高度固定且可自訂寬度。
  • CompactChipTitleChip - 標準方塊的兩種變化版本,分別具有較小和較大高度,且可包含一行文字。
  • CircularProgressIndicator - 在螢幕邊緣周圍加上彩色弧形,並具有指定的開始和結束角度,可描述完整或部分圓圈,背後有完整的進度弧線。
  • Text - 使用建議的 Wear Material 字體樣式的樣式化文字

這些元件都有各自的顏色物件 (可透過主要 Colors 類別建構),輕鬆對所有元件套用相同的主題。除了顏色以外,您也可以使用 Typography 類別輕鬆使用字體排版名稱取得 FontStyle 物件。

除了元件之外,還有建議的圖塊版面配置:

  • PrimaryLayout - 版面配置可自訂,包含主要或次要標籤、中間內容,以及底部的主要方塊。這個版面配置中的主要內容可新增為 MultiSlotLayoutMultiButtonLayout 物件。
  • EdgeContentLayout - 代管 CircularProgressIndicator 周圍的版面配置,並在其中放置主要內容,以及周圍有主要或次要標籤。
  • MultiButtonLayout - 版面配置可包含 1 到 7 個按鈕,並按照 Material Design 指南排列 (視數字而定)。
  • MultiSlotLayout - 列狀樣式版面配置,水平對齊且有間隔版位 (適用於圖示或其他小型內容)。

所有版面配置均套用了符合 Material 指南建議的邊框間距和樣式。

API 變更

  • 為 Chip 元件進行重大重構,包括 Builder 中的分隔 setter,讓內容的每個部分都分別傳入,以符合規範 (主要標籤、次要標籤、圖片資源 ID)。此外,如未設定,系統會自動產生內容說明。(I57622)。
  • ProgressIndicatorLayout」已重新命名為「EdgeContentLayout」。(Ic1aa6)。
  • 按鈕大小內容已重新命名為 without _BUTTON 後置字串,並在 Button 中加上額外的 Javadocs 說明。(I1dfe2)。

修正錯誤

  • 更新 Material Layouts 中的邊界、邊框間距和整體排列方式,以因應所有類型的建議版面配置和螢幕大小和形狀。
  • 改善 Material 版面配置。在 MultiSlotLayout 版位中,現在可以彈性調整寬度,而非固定大小 (I52919)、(If18b4)
  • CompactChip 上輕觸的區域已調高,以符合無障礙指南。(Ie8264)。

1.1.0-alpha09 版本

2022 年 6 月 29 日

發布 androidx.wear.tiles:tiles-*:1.1.0-alpha09查看 1.1.0-alpha09 版的修訂項

新功能

  • 我們已在 ProgressIndicatorLayout 中新增選用標籤,並為這項功能提供了相關支援。(I30788)。

API 變更

  • ElementMetadata 的輔助方法現在接受 ElementMetadata,而非修飾元。(I5a70f)。

修正錯誤

  • 已移除 CompactChip 的字元限制 (最多 9 個字元)。如果文字過大,無法容納於 PrimaryLayout 的螢幕上,系統會將文字縮到刪節號。(Id56ec)。
  • Chip 中的 getter 現在可以加上 Content 後置字串。(Iba437)。
  • 橫跨 Tiles Material 類別的 Javadoc 說明。(I56e41)、(I80f31)、(Iba437)

1.1.0-alpha08 版本

2022 年 6 月 1 日

發布 androidx.wear.tiles:tiles-*:1.1.0-alpha08查看 1.1.0-alpha08 版的修訂項

新功能

  • 在修飾符中新增中繼資料標記,以便在 Helper 類別中加入輔助方法,用來追蹤元件的中繼資料。(I70db2)、(I30c3d)
  • 為所有 Tiles Material 內部元件和版面配置新增靜態方法 fromLayoutElement。此項目應作為測試用途,您可以藉此將存取容器內容時取得的 LayoutElement 投放到原始的類型。(Ia572a)、(Idbd8a)、(I3ae13)、(I292fe)、(I8b20f)、(I3cacb)、(I84b24)

1.1.0-alpha07 版本

2022 年 5 月 18 日

發布 androidx.wear.tiles:tiles-*:1.1.0-alpha07查看 1.1.0-alpha07 版的修訂項

API 變更

  • 與不同內容 setter 相關的 getter 現已新增至 ProgressIndicatorLayoutPrimaryLayout。現在,這些類別中的所有 setter 都有相符的 getter。(Iddbe5)(Iabe4e)。
  • Material 元件中內容說明的 getter 可以傳回空值,因為其 setter 並非強制性。
  • 如果嘗試建立不含傳遞內容的 Button,便會產生 IllegalArgumentException。(I7fc0c)。
  • ChipColors 中的圖示顏色相關欄位已從 iconTintColor 重新命名為 iconColor。(Ic053b)。

修正錯誤

  • 為 Tiles Material 中的 Layouts 新增 androidTests。(I96404)。

1.1.0-alpha06 版本

2022 年 5 月 11 日

發布 androidx.wear.tiles:tiles-*:1.1.0-alpha06查看 1.1.0-alpha06 版的修訂項

新功能

  • 新的版面配置已新增至 Material Layouts 子程式庫 - MultiButtonLayout。它代表可包含 1 到 7 個按鈕的版面配置,並依照 Material Design 指南排列。在大多數情況下,這個版面配置應以內容的形式傳入 PrimaryLayout。 (Ib727f)。

API 變更

  • MultiSlotLayout 已重構,使其只包含版位。這個版面配置應以內容的形式傳遞至主要 PrimaryLayout。(I1870f)。
  • 已將 CircularProgressIndicator 的定義預設顏色更新為單一值,而不是主要和次要值。(I64a51)。
  • 已在 MultiSlotLayout 中新增水平空格的 getter。(I11e1e)。

修正錯誤

  • 元件的 Android 測試已新增至 Tiles Material 中。(I20041)。

1.1.0-alpha05 版本

2022 年 4 月 6 日

發布 androidx.wear.tiles:tiles-*:1.1.0-alpha051.1.0-alpha05 版本包含這些修訂版本。

新功能

  • 新增了輔助方法,以將 LayoutElement 轉換為版面配置、時間軸、時間軸項目為這些類別,以便簡化 Tiles 建構作業。(I2f6d1)。
  • 已將 Colors 物件新增至 Material 程式庫,作為主題在各個元件顏色中傳遞。(I0792c)。

API 變更

  • Material Text 元件需要將文字傳入建構函式中。現在可以透過設定權重來自訂此元件。(I25dbd)。
  • ChipDefaults 中移除未在公用設定器上使用的常數。(I7baed)。
  • 已從 CompactChip 和 中移除 getter沒有相符 setter 的 TitleChip。(I99e85)。
  • DEFAULT_PADDING 已從 ProgressIndicatorDefaults 移除。(Idabcd)。
  • Material 元件現在接受 CharSequence 做為內容說明,而非字串。(I5b21a)。

修正錯誤

  • 以重構設定器的方式在 Button 中實作可選參數。(Ib7135)。
  • 字型樣式變數已新增至 Typography 字型中。(I8dbc6)。

1.1.0-alpha04 版本

2022 年 3 月 23 日

發布 androidx.wear.tiles:tiles-*:1.1.0-alpha041.1.0-alpha04 版包含此連結所列的修訂項目。

新功能

  • 您可以選擇將主要或次要標籤新增至 PrimaryLayout。(Ib9916)。
  • 您可以透過設定溢位、斜體、底線等方式自訂文字元件 (I703f7)。

API 變更

  • 已從 Tiles Material API 中移除預設色彩常數。(I0ab55)。
  • 所有 Tiles Material 中的可點擊元件都需要使用 Builder 建構函式中的 Clickable 物件,而不是 Action。(I2f101)。

修正錯誤

  • 文字現在會在方塊與文字元件的溢位時畫出刪節號。(I8a2f8)。
  • 改善的元件會在使用者字型調整為大時呈現。(Ib63b1)。
  • 在主版面配置中,清楚說明 setPrimaryChipContent 的 Javadocs。(Ie6296)。

1.1.0-alpha03 版本

2022 年 2 月 23 日

發布 androidx.wear.tiles:tiles-*:1.1.0-alpha031.1.0-alpha03 版包含此連結所列的修訂項目。

API 變更

  • 已將帶有推薦字體類型的 Text 元件新增至 TIles Material。(Iec0ae)。

1.1.0-alpha02 版本

2022 年 2 月 9 日

發布 androidx.wear.tiles:tiles-*:1.1.0-alpha02查看 1.1.0-alpha02 版的修訂項

新功能

  • Tiles Material 中新增了一個 layouts 子程式庫。其中包含可自主設計的 Tiles 版面配置,該配置帶有建議的邊框間距和邊界,讓 Tile 開發作業更快速且更易於實作。初始版面配置如下:
    • PrimaryLayout (I7ba91) 代表版面配置,底部有主要晶片,中部是內容部分。
    • MultiSlotLayout (I32104) 代表版面配置,在第 1 列和第 3 列使用標籤,第 2 列水平對齊並有間隔版位,後面接著包含主要方塊的第 4 列。
    • ProgressIndicatorLayout (I9fec6) 代表版面配置,螢幕邊緣周圍的圓形進度指標,以及內部顯示的內容。
  • CircularProgressIndicator (Ic4b88) 已新增至 Tiles Material 元件。

API 變更

  • 已重新命名 TitleChip 使用的剩餘常數,並在名稱中加入了標題。(I14f4c)。
  • 已將 setHorizontalAlignment 方法新增至 Chip。(Ie6e0b)。

1.1.0-alpha01 版本

2022 年 1 月 26 日

發布 androidx.wear.tiles:tiles-*:1.1.0-alpha011.1.0-alpha01 版包含以下修訂項目。

新功能

  • 已新增程式庫 Tiles Material。其中包含的元件,可以在使用 Material 設計的情況下更快速、更方便地建構 Tiles 版面配置。初始元件如下:
    • Button
    • Chip
    • CompactChip
    • TitleChip

修正錯誤

  • 修正 TileUiClient 中導致快取資源被捨棄的錯誤。(I60e0b)。

1.0 版本

1.0.1 版

2022 年 1 月 26 日

發布 androidx.wear.tiles:tiles-*:1.0.11.0.1 版包含以下修訂項目。

修正錯誤

  • 修正 TileUiClient 中導致快取資源被捨棄的錯誤。(I60e0b)。

1.0.0 版本

2021 年 11 月 3 日

發布 androidx.wear.tiles:tiles-*:1.0.01.0.0 版包含此連結所列的修訂項目。

1.0.0 的主要功能

  • Wear Tiles 程式庫提供為 Wear OS 裝置建構自訂資訊方塊的功能,以及可讓系統擷取資訊方塊並顯示在錶面旁邊的類別。
  • 資訊方塊轉譯器可讓您在 Android Activity 中顯示資訊方塊,以便快速測試資訊方塊版面配置。

1.0.0-rc01 版

2021 年 10 月 27 日

發布了 androidx.wear.tiles:tiles-*:1.0.0-rc011.0.0-rc01 版包含以下修訂項目。

1.0.0-beta01 版

2021 年 10 月 13 日

發布 androidx.wear.tiles:tiles-*:1.0.0-beta011.0.0-beta01 版包含此連結所列的修訂項目。

修正錯誤

  • 修正了 TileUiClient 中有空白儲存格時 NullPointerException 的問題 提供了資源版本。(I0586e)。

1.0.0-alpha12 版

2021 年 9 月 29 日

發布 androidx.wear.tiles:tiles-*:1.0.0-alpha121.0.0-alpha12 版包含此連結所列的修訂項目。

修正錯誤

  • UpdateScheduler 不再使用弱點 參考資料,修正 TileUiClient 無法更新的問題(I1120db/199061124)

  • 宣告 SysUiTileUpdateRequester 查詢 PacakgeManager,並修正 資訊方塊更新無法在 R+ 裝置上運作的錯誤。(I1120d)。

1.0.0-alpha11 版本

2021 年 9 月 1 日

發布 androidx.wear.tiles:tiles-*:1.0.0-alpha111.0.0-alpha11 版本包含以下修訂項目。

新功能

  • 新增並發布了測試程式庫 (androidx.wear.tiles:tiles-testing 程式庫),可讓開發人員更輕鬆地測試圖塊。(Iedb6b)。

API 變更

  • TileProviderService 已重新命名為 TileService。(I1ad2c)。
  • 已更新資訊方塊建構工具。靜態的 .builder() 方法 淘汰了改用 new Foo.Builder() 和 setter 移除接受 Builder 執行個體的超載。(Ia9606)。
  • TileRenderer 現在應使用 UI 內容,而不是 應用程式結構定義。(I84b61)。

修正錯誤

  • 修正在特定情況下套用多個底線的錯誤 情境。(Ib6712)。

1.0.0-alpha10 版本

2021 年 8 月 18 日

發布 androidx.wear.tiles:tiles:1.0.0-alpha10androidx.wear.tiles:tiles-proto:1.0.0-alpha10androidx.wear.tiles:tiles-renderer:1.0.0-alpha101.0.0-alpha10 版包含此連結所列的修訂項目。

API 變更

  • 已從公用 API 移除了版面配置檢查工具。永遠都會 已啟用,但只會在檢查失敗時發出警告。(Ie9f29)。
  • TileRenderer 現在接受 UI 內容,而非應用程式內容。

修正錯誤

  • 修正了防止 Spannable 中可點擊元素被點擊的錯誤。

1.0.0-alpha09 版本

2021 年 7 月 21 日

發布 androidx.wear.tiles:tiles:1.0.0-alpha09androidx.wear.tiles:tiles-proto:1.0.0-alpha09androidx.wear.tiles:tiles-renderer:1.0.0-alpha091.0.0-alpha09 版包含此連結所列的修訂項目。

新功能

  • 已將版面配置檢查器新增至 Wear Tiles轉譯器。(I3a869)。
    • 這些檢查器可用於驗證您的圖塊中的最佳做法。首先,如果圖塊中不含任何帶有 Semantics 修飾元的元素,這些檢查器將提出警告。
  • 已新增 DefaultTileProviderClientTestingTileProviderClient constructors。(I9f4b9)。

API 變更

  • 在 TileProviderClient (I0ec36) 中重新命名:
    • getApiVersion -> requestApiVersion
    • tile/resourcesRequest -> requestTile/Resources
    • onTileFooEvent -> sendOnTileFooEvent
  • 已將版面配置檢查器新增至 Wear Tiles轉譯器。(I3a869)。

修正錯誤

  • 確保 LaunchAction 目標沒有特殊項目 授予其要求的權限。(I39136)。

1.0.0-alpha08 版本

2021 年 6 月 30 日

發布 androidx.wear.tiles:tiles:1.0.0-alpha08androidx.wear.tiles:tiles-proto:1.0.0-alpha08androidx.wear.tiles:tiles-renderer:1.0.0-alpha081.0.0-alpha08 版包含此連結所列的修訂項目。

新功能

  • Spannables 現在支援 line_height 而非 line_spacing。

API 變更

  • 在 Spannables 中新增對 line_height 的支援,移除 line_spacing。(Ibeb54)。
    • 應該轉移使用了 line_spacing 的代碼,轉而使用 line_height。

修正錯誤

  • 使用比例維度修正錯誤。(I37ace)。
  • 修正防止文字元素含有內容說明的錯誤。(Id2c7d)。

1.0.0-alpha07 版本

2021 年 6 月 16 日

發布 androidx.wear.tiles:tiles:1.0.0-alpha07androidx.wear.tiles:tiles-proto:1.0.0-alpha07androidx.wear.tiles:tiles-renderer:1.0.0-alpha07查看 1.0.0-alpha07 版的修訂項

API 變更

  • 新增 TileProviderClient 介面並公開 DefaultTileProviderClient,允許實作繫結至 TileProviderService 介面。(I69165)。

1.0.0-alpha06 版本

2021 年 6 月 2 日

發布 androidx.wear.tiles:tiles:1.0.0-alpha06androidx.wear.tiles:tiles-proto:1.0.0-alpha06androidx.wear.tiles:tiles-renderer:1.0.0-alpha06查看 1.0.0-alpha06 版的修訂項

API 變更

  • 所有建構工具類別現在都包含所有屬性的 getter。請注意,這些建構工具僅供測試 (I9d155)
  • 套件變更:androidx.wear.tiles.builders 中的類別已移至 androidx.wear.tiles
  • 為 Tiles 新增實驗性色調支援。(I38929)。
  • 已將 LayoutElementBuilders.HALIGN_* 重新命名為 LayoutElementBuilders.HORIZONTAL_ALIGN_* (I67e58)
  • 已將 LayoutElementBuilders.VALIGN_* 重新命名為 LayoutElementBuilders.VERTICAL_ALIGN_* (I67e58)
  • 已將 LayoutElementBuilders.SPAN_VALIGN_* 重新命名為 LayoutElementBuilders.SPAN_VERTICAL_ALIGN_* (I67e58)
  • 已新增要求和事件的建構工具類別。(Ib5cf4)。
  • 已經遷移 TileProviderService,改為使用 RequestBuildersEventBuilders 的要求和事件類別,而不是 RequestReaders/EventReaders (例如 onTileRequest 現已提供 RequestBuilders.TileRequest,而不是 RequestReaders.TileRequest)。(I46ea1)。

修正錯誤

  • 修正 Tiles 轉譯器的非同步圖片載入錯誤。(Iad9b0)。
  • 修正以下版面配置錯誤:將寬度或高度設為 expand() 的圖片放置在寬度或高度設為 wrap()Box 中。(I33770)。

1.0.0-alpha05 版本

2021 年 5 月 18 日

發布 androidx.wear.tiles:tiles:1.0.0-alpha05androidx.wear.tiles:tiles-proto:1.0.0-alpha05androidx.wear.tiles:tiles-renderer:1.0.0-alpha05查看 1.0.0-alpha05 版的修訂項

API 變更

  • 已將 getTileId 從傳入的圖塊事件中移除 (TileAddEventTileRemoveEventTileEnterEventTileLeaveEventTileRequest)。(Ifbba2)。
  • ImageResource#setAndroidResourceByResid 已重新命名為 setAndroidResourceByResId (I4ba6e)
  • 重新命名 TimelineManager#deInit 以關閉並導入 AutoCloseable。(I5dff2)。

1.0.0-alpha04 版本

2021 年 5 月 5 日

發布 androidx.wear.tiles:tiles:1.0.0-alpha04androidx.wear.tiles:tiles-proto:1.0.0-alpha04androidx.wear.tiles:tiles-renderer:1.0.0-alpha041.0.0-alpha04 版包含以下修訂項目。

API 變更

  • 隱藏了具體的 TileProviderService 類別。
    • Made TileUpdateRequester 採用 Class<? extends TileProviderService>。(Ib7cca)。
  • 新增了向 AndroidActivity 添加額外項目的能力。(I748f4)。

Tiles 1.0.0-alpha03 版

2021 年 4 月 21 日

發布 androidx.wear.tiles:tiles:1.0.0-alpha03androidx.wear.tiles:tiles-proto:1.0.0-alpha03androidx.wear.tiles:tiles-renderer:1.0.0-alpha03查看 1.0.0-alpha03 版的修訂項

API 變更

  • 重新命名 TileManager ->TileClient
    • 重新命名 TileManager#create ->TileClient#connect (I91839)

修正錯誤

  • 新增了 Proguard 規則,以確保 tilestiles-renderer 在啟用 Proguard 後能夠正常運作 (Ie3d85)

1.0.0-alpha02 版

2021 年 4 月 7 日

發布 androidx.wear.tiles:tiles:1.0.0-alpha02androidx.wear.tiles:tiles-proto:1.0.0-alpha02androidx.wear.tiles:tiles-renderer:1.0.0-alpha021.0.0-alpha02 版本包含以下修訂項目。

API 變更

  • androidx.wear:wear-tiles 已移動群組,現在稱為 androidx.wear.tiles:tiles
  • androidx.wear:wear-tiles-renderer 已移動群組,現在稱為 androidx.wear.tiles:tiles-renderer
  • TileRenderer.LoadActionListener 現在會使用 androidx.wear.tiles.builders.StateBuilders.State 的執行個體,而非 androidx.wear.tiles.proto.StateProto.State
  • TileRenderer 現在接受來自 androidx.wear.tiles.builders.ResourceBuilders.Resources 的 Tile 資源,而不是 androidx.wear.tiles.renderer.ResourceAccessors 的執行個體。

修正錯誤

  • 修正了無法使用 LoadActionListener 的問題,因為它公開了內部類別。

1.0.0-alpha01 版

2021 年 3 月 10 日

發布 androidx.wear:wear-tiles:1.0.0-alpha01androidx.wear:wear-tiles-proto:1.0.0-alpha01androidx.wear:wear-tiles-renderer:1.0.0-alpha011.0.0-alpha01 版本包含這些修訂版本。

新功能

  • Wear Tiles Renderer 程式庫提供建構自訂的功能 Wear OS 裝置的資訊方塊,以及允許系統的類別 擷取資訊方塊,然後顯示在錶面旁邊。
,瞭解如何調查及移除這項存取權。