Glance
最新版 | 穩定版 | 候選版 | Beta 版 | Alpha 版 |
---|---|---|---|---|
2022 年 10 月 5 日 | - | - | - | 1.0.0-alpha05 |
宣告依附元件
如果要為 Glance 新增依附元件,必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。
在應用程式或模組的 build.gradle
檔案中,新增您需要的構件依附元件:
Groovy
dependencies { // For AppWidgets support implementation "androidx.glance:glance-appwidget:1.0.0-alpha05" // For Wear-Tiles support implementation "androidx.glance:glance-wear-tiles:1.0.0-alpha05" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.0-beta03" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { // For AppWidgets support implementation("androidx.glance:glance-appwidget:1.0.0-alpha05") // For Wear-Tiles support implementation("androidx.glance:glance-wear-tiles:1.0.0-alpha05") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.0-beta03" } kotlinOptions { jvmTarget = "1.8" } }
如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。
意見回饋
您的意見可協助我們改善 Jetpack。發現新的問題或有改善這個程式庫的想法時,請告訴我們。建立新的問題之前,請先查看這個程式庫中的現有問題。如果要投票給現有問題,只要按一下星號按鈕即可。
詳情請參閱 Issue Tracker 文件。
1.0.0 版本
1.0.0-alpha05 版本
2022 年 10 月 5 日
發布 androidx.glance:glance:1.0.0-alpha05
、androidx.glance:glance-appwidget:1.0.0-alpha05
和 androidx.glance:glance-wear-tiles:1.0.0-alpha05
。1.0.0-alpha05 版本包含以下修訂項目。
新功能
- 將
requestPinGlanceAppWidget
新增至GlanceAppWidgetManager
,讓應用程式提示使用者將 Glance 型小工具新增至主畫面。(Ic6e47) - 將
ACTION_DEBUG_UPDATE
新增至GlanceAppWidgetReceiver
,讓開發人員強制要求小工具從已解鎖裝置和模擬器的 ADB 中更新。(I94ae1)
API 變更
- 移除 Glance 範本中的標頭動作按鈕,藉此簡化用途。(Ie4387)
- 重構單一實體範本,以便重複使用區塊子系統設計。(Iecd2c)
- 重構 Glance 清單範本,以便使用
Text/Image/Action
區塊設計。(If0cc1) - 新增
TextBlock
和ImageBlock
的優先順序值範圍。(I73100)
修正錯誤
- 已移除 Material3 依附元件。(I28d1c)
- 改用更加一致的系統,在 Glance 範本版面配置中增加邊界和間距。(I29773)
- 修正格式錯誤的 Proguard 規則,以免導致無法建構壓縮版本。
1.0.0-alpha04 版本
2022 年 8 月 10 日
發布了 androidx.glance:glance:1.0.0-alpha04
、androidx.glance:glance-appwidget:1.0.0-alpha04
和 androidx.glance:glance-wear-tiles:1.0.0-alpha04
。1.0.0-alpha04 版本包含以下修訂項目。
新功能
- 新增按鈕顏色功能。
- 新增
GlanceComposable
註解,以改善編譯時間檢查。 - 新增 Wear 專屬 Glance 功能。
API 變更
- 更新 Glance Gallery Data API 和精簡檢視 (Ibc7a8)。
- 新增
ButtonColors
以設定按鈕 (Iea88d、b/236305351)。 - 將
ColorProvider.resolve
重新命名為ColorProvider.getColor
(Ic9dfe) - 將
copy()
方法新增至TextStyle
(I9aef6)。 - 新增
ColorProviders
類別,可做為 Glance 主題的一部分 (I848b9、b/237012816)。 - 為清單樣式和收合的檢視畫面新增清單範本支援 (I50cdc)。
- 在
GlanceModiier
和GlanceCurvedModifier
中新增語意 (Ifda7e)。 - 新增
GlanceComposable
註解 (I5dbf0)。 - 將 Glance 範本移至主要的 Glance 專案 (I9db94)。
- 新增
ColorProvider.resolve()
(Ife532、b/214733442) - 從現有
appWidgetId
或設定活動中的意圖取得GlanceId
的新方法 (Icb70c、b/230391946) - 新增
GlanceComposable
註解 (I2c21f)。 - 已新增
GlanceRemoteViews
,以便在GlanceAppWidget
以外的位置執行組合 (I18f92)。 - 移除
ProgressIndicatorDefaults
中的顏色 (I40299)。 - 按照 API 審查意見回饋的要求,將
ActionCallback
的 onRun 方法重新命名為 onAction,以與公用 API 保持一致 (Icfa57)。 - 轉換 glance 範本版面配置以使用地圖 (I46bfd)
- 新增
RadioButton
可組合項 (I4ecce) - 新增了
GlanceWearTiles
用於撰寫 wear 資訊方塊 (Ia9f65) - 新增了
GlanceCurvedModifier
的可點擊屬性 (Iec2a0) - 實作
CurvedRow
範圍,並建立 DSL,以新增一般的可組合元素和/或曲線元素。在 proto 圖塊中一併新增curvedLine
和curvedSpacer
,並轉換為ArcLine
和ArcSpacer
(Ib955b) - 根據 Tiramisu DP2 (I0cbb7) 更新了核心和 Appcompat 的空值
- 在 glance-wear-tiles 中新增對
RuncallbackAction
的支援,目前僅支援沒有參數的RunCallbackAction
(Ide64a)
外部貢獻
- 由於 test-coroutines-lib 遷移,更新了:compose:ui:ui-test API (updateApi) (I3366d)
1.0.0-alpha03 版本
2022 年 2 月 23 日
發布了 androidx.glance:glance-*:1.0.0-alpha03
。1.0.0-alpha03 版本包含以下修訂項目。
新功能
- 將狀態定義簡化為「偏好設定」。
API 變更
- 將
PreferencesGlanceStateDefinition
設為預設狀態處理,藉此簡化狀態處理。移除了GlanceAppWidget.updateAppWidgetState
及引入updateAppWidgetState
,其預設使用Preferences
(I58963)。 - 新增 Glance TemplateText 類別,及更新範本設計 (I4e146)
- 為任意形式的範本新增概述架構 (If03d6)
- 更新至
SingleEntityTemplate
版面配置 (If925d) - 新增了
LazyVerticalGrid
(I5f442) - 在
SingleEntityTemplate
上使用ColorProvider
(I01ee0) - 更新範本類別名稱 (I3720e)
- 新增了
LinearProgressIndicator
及CircularProgressIndicator
可組合項 (Ie116b)。
修正錯誤
- 初始化 glance 範本實作,定義「單一項目範本」資料及範例範本版面配置 (I35837)
- 根據預設,將設定方塊內容置中對齊 (I264be)
- 修正 glance-wear-圖塊中的 fillMaxSize/Width/Height 錯誤 (I0a39f)
1.0.0-alpha02 版本
2022 年 1 月 26 日
發布了 androidx.glance:glance-*:1.0.0-alpha02
。1.0.0-alpha02 版本包含以下修訂項目。
新功能
這個版本包含一組 API,可以使用 Compose 執行階段透過「Glanceable」的最佳化可組合項來建構 Wear 圖塊
- 透過擴充
GlanceTileService
以宣告 Wear 圖塊服務,這是用來在 Composable Content() 函式中建立圖塊的服務。 - 特定於瀏覽的 Wear 圖塊的可組合項:
CurvedRow
、CurvedText
。 - 定義
TimelineMode.SingleEntry
及TimelineMode.TimeBoundEntries
,以處理不同的圖塊時間軸模式。 LocalTimeInterval
,本機組合是指特定時間間隔。BorderModifer
是一個GlanceModifier
,會在元素周圍套用框線。
這個版本也會為 AppWidget Glance. 新增進度指標。
API 變更
- 新增了
LinearProgressIndicator
及CircularProgressIndicator
可組合項 (Ie116b)。 - 將
actionStartBroadcastReceiver
變更為actionSendBroadcast
(I7d555) - 將結構定義傳送至
GlanceAppWidget
onDelete 回呼 (I4c795)
修正錯誤
- 正確處理 OPTIONS_APPWIDGET_SIZES (如有且為空) (I01f82)。
1.0.0-alpha01 版本
2021 年 12 月 15 日
發布了 androidx.glance:glance:1.0.0-alpha01
、androidx.glance:glance-appwidget:1.0.0-alpha01
和 androidx.glance:glance-appwidget-proto:1.0.0-alpha01
。1.0.0-alpha01 版本包含這些修訂版本。
初始版本中的功能
- 第一版 Glance 提供第一組 API,用以使用 Compose Runtime 建立 AppWidget,以及一組為「可瀏覽」最佳化的新的可組合項。
特色
- 透過 GlanceAppTool 及 GlanceAppToolReceiver 宣告應用程式小工具。
- 使用初始「瀏覽」可組合項建構 UI:方塊、列、欄、文字內容。、按鈕、延遲欄、圖片、空格。
- 使用 GlanceModifier 方法對可組合元素套用修飾詞。
- 使用預先定義的操作處理使用者互動。
- 使用 ActionParameters 為操作提供參數。
- 處理 不同大小模式的方法是,定義 SizeMode.Single、SizeMode.Exact 或 SizeMode.Responsive。
- 透過提供 GlanceStateDefinition,保留 GlanceAppWidget 狀態。
- 本地組合,例如 LocalContext、LocalState、LocalGlanceId、LocalSize。
- 與現有的 RemoteViews 以及 AndroidRemoteViews 可組合元素互通。