資訊一覽

宣告依附元件

如要為 Glance 新增依附元件，您必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

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

dependencies {
    // For Glance support
    implementation "androidx.glance:glance:1.2.0-alpha01"
    // For AppWidgets support
    implementation "androidx.glance:glance-appwidget:1.2.0-alpha01"

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

dependencies {
    // For Glance support
    implementation("androidx.glance:glance:1.2.0-alpha01")
    
    // For AppWidgets support
    implementation("androidx.glance:glance-appwidget:1.2.0-alpha01")

    // 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.2 版本

1.2.0-alpha01 版本

2025 年 5 月 7 日

發布 androidx.glance:glance-*:1.2.0-alpha01。1.2.0-alpha01 版包含這些修訂版本。

API 變更

• currentCompositeKeyHash 目前已淘汰。請改用 currentCompositeKeyHashCode。替換 API 會使用更多位元組編碼相同的雜湊，因此組合階層中兩個隨機不相關群組使用相同雜湊鍵的機率會以指數方式降低。(I4cb6a、b/177562901)
• 新增 API，可為 Glance 圖片可組合函式和背景圖片修飾符指定 alpha (0f 到 1f)。如未指定，系統會保留來源圖片的 alpha 值。(I8ad05)。
• 為產生的預覽畫面新增 Glance API。覆寫 GlanceAppWidget.providePreview，為小工具提供預覽版面配置。接著，呼叫 GlanceAppWidgetManager.setWidgetPreview 來設定預覽畫面。(Iced16)
• 新增 MultiProcessGlanceAppWidget 以支援多程序設定 (Idbb90)
• 移除實驗性標記，我們現在支援 lambda (I74d98、b/299361317)
• 允許指定 GlanceAppWidget.runComposition 的 lambda 接收器 (I84829)
• 將 previewSize 參數新增至 requestPinGlanceAppWidget (I9f8f0、b/303256067)

修正錯誤

• 移除新平台 API 存取權的手動設定，因為在使用 AGP 7.3 以上版本 (例如 R8 3.3 版) 的 R8 時，以及在使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 的所有版本時，系統會透過 API 模擬功能自動執行此操作。建議未使用 AGP 的用戶端更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(If6b4c、b/345472586)。
• 將 glance-appwidget 程式庫更新為 compileSdk 35 (I2e26b)

1.1 版本

1.1.1 版

2024 年 10 月 16 日

發布 androidx.glance:glance-*:1.1.1。1.1.1 版包含這些修訂項目。

安全性修正項目

• 自這項異動起，androidx 會針對 protobuf 4.28.2 進行編譯，以解決 CVE-2024-7254 問題。將 androidx.glance:glance-appwidget-proto 和 androidx.glance:glance-appwidget-external-protobuf 的依附元件升級至 1.1.0 版，以解決安全漏洞風險。

1.1.0 版本

2024 年 6 月 12 日

發布 androidx.glance:glance-*:1.1.0。1.1.0 版包含這些修訂版本。

自 1.0.0 版以來的重要變更

• 將 Glance 移至 1.1.0 穩定版。

1.1.0-rc01 版本

2024 年 5 月 14 日

發布 androidx.glance:glance-*:1.1.0-rc01。1.1.0-rc01 版包含這些修訂版本。

新功能

• 在 Glance 的預覽註解中新增寬度和高度參數。將 1.1.0 移至候選版。

API 變更

• 將選用參數新增至 Scaffold。(If753f)
• 在 Glance @Preview 中新增寬度和高度參數。(Ibabe8)。
• 移除對 Glance Wear 資訊方塊預覽畫面的支援。(I3850a)
• 新增 API，可設定 FontStyle 的自訂權重值。(I7390a)。
• 重新命名 Viewfinder 的 ImplementationMode 列舉，以更貼切反映基礎實作方式，並為 TransformationInfo.sourceRotation 新增固定常數 (Ic6149)

修正錯誤

• 修正在回溯相容性模式下，導致 ViewGroups 顯示問題的錯誤 (I8de92)

外部貢獻

• 實驗性的 SharedTransitionScope 現在是介面，而非類別。(Iaf856、b/338415048、b/338414702)

1.1.0-beta02 版

2024 年 4 月 17 日

發布 androidx.glance:glance-*:1.1.0-beta02。這個版本包含先前版本中缺少的來源 JAR 檔案。

1.1.0-beta01 版本

2024 年 4 月 3 日

發布 androidx.glance:glance-*:1.1.0-beta01。1.1.0-beta01 版本包含這些修訂版本。

1.1.0-alpha01 版本

2024 年 2 月 7 日

發布 androidx.glance:glance-*:1.1.0-alpha01。1.1.0-alpha01 版包含以下修訂項目。

新功能

• 適用於 Glance 的單元測試程式庫，不需使用 UI Automator。您可以直接測試 Glance 程式碼，不必先將檢視區加載。
• 更高階的元件，可用於簡化版面配置。
• 新的修飾符和主題選項。
• 新的 API，可從組合函式取得 RemoteView 的流程，runComposition

API 變更

• 在 Glance 主題中新增 widgetBackground 色彩角色。(Ia2ab8)。
• 新增 GlanceAppWidget.runComposition (I6344c、b/298066147)
• 新增 TopBar 元件 (Ibd361)
• 為 clickable 修飾符新增覆寫值。(Iacecf)
• 新增用於著色按鈕的新 API。在 1.0 版發布前，這項功能應處於實驗階段。(I92523)。
• 新增 runGlanceAppWidgetUnitTest，提供範圍以便在 GlanceAppWidgetUnitTest 上呼叫方法，例如 provideComposable，以便提供可供測試的小型隔離可組合函式，onNode 可在提供的內容中找到 Glance 可組合函式元素。這樣一來，您就能為應用程式小工具中的個別可組合函式編寫單元測試，驗證函式在特定輸入值下會輸出預期的 Glance 可組合元素集合。(I2f682)
• 在語意中新增 testTag 修飾符，以便在單元測試中使用。(I8f62f)。
• 更新 TitleBar - 文字和圖示可個別套用顏色。(Ia0a60)
• 新增 Scaffold 元件 (I8a736)
• 新增 hasActionRunCallbackClickAction 篩選器和 assertHasActionRunCallbackClickAction 斷言，以測試 actionRunCallack。此外，我們也為動作相關的測試篩選器新增了額外的簡寫變化版本函式 - hasStartActivityClickAction<activityClass>(..)、hasStartServiceAction<receiverClass>(..)、hasSendBroadcastAction<receiverClass>(..)。為 assertHasXXX 對應項目新增類似的變化版本。(Ieca63)
• 移動未發布的 API。將修飾符從內部變更為公開，但限制使用於程式庫 (If2a08)
• 新增 onCompositionError 方法，讓開發人員在發生錯誤時執行程式碼 (I9b56f)
• 新增按鈕和圖示按鈕 API 至 Glance (I0fd6f)
• 新增 isLinearProgressIndicator、isIndeterminateLinearProgressIndicator、isIndeterminateCircularProgressIndicator 篩選器，以符合進度指標。另外，還包含 hasAnyDescendants 篩選器，用於測試節點的子階層中是否有與特定比對器相符的子項 (Ifd426)
• 新增斷言和篩選器，以便測試啟動服務 / 活動或廣播的點擊動作。也包括測試輸入元素是否已勾選。(I3041c)

1.0.0 版本

1.0.0-alpha06 版本

2024 年 2 月 7 日

發布 androidx.glance:glance-appwidget-preview:1.0.0-alpha06 和 androidx.glance:glance-preview:1.0.0-alpha06。1.0.0-alpha06 版包含此連結所列的修訂項目。

新功能

• 版本已更新，以便追隨主要的 Glance 模組。

1.0.0 版本

2023 年 9 月 6 日

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

1.0.0 的主要功能

• 將 Glance 移至 1.0.0 穩定版

1.0.0-rc01 版

2023 年 7 月 26 日

發布 androidx.glance:glance-*:1.0.0-rc01。1.0.0-rc01 版包含以下修訂項目。

將 Glance 移至 rc01，以便發布 1.0.0 穩定版。

新功能

• 在動作 lambda 中加入重要參數，以便更穩定地叫用動作。
• 新增可提供至 ActvityOptions 至 startActivity 動作的功能。
• 新增對 Android 14 的支援

API 變更

• 為所有接受 lambda 的元素新增選用鍵參數。(Id96c1、b/282445798)。
• 新增支援為 actionStartActivity 設定 ActivityOptions 套件的功能 (I6a08d)
• 針對 d、e、f、g 路徑合併公開和實驗性 API 檔案 (I03646、b/278769092)
• 不適用，API 檔案變更只是重新排序方法 (I5fa95)
• 新增 API，可為 GlanceAppWidgetReceiver 要求設定 CoroutineContext (I0a100)
• 新增 API 為 LazyColumn 和 LazyVerticalGrid 提供 ActivityOptions，用於清單中的所有動作。(Id8d71)

修正錯誤

• 不適用，API 檔案變更只是重新排序方法 (I5fa95)
• Glance 文字元件樣式示範 (Ie78a4)

1.0.0-beta01 版

2023 年 5 月 10 日

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

新功能

• 將程式庫移至 Beta 版。
• 支援使用 GlanceTheme 設定主題，新增 glance-material 和 glance-material3 模組，以便在 Glance 中支援 Material 2 和 Material 3 樣式主題。
• 支援 FontFamily 已新增至文字 API。
• 將 GlanceAppWidget 移至以 WorkManager 工作階段為基礎的更新機制。AppWidgets 的 Glance 使用者現在應覆寫 GlanceAppWidget.provideGlance，而非舊版 Content 方法。由於這項作業現在會在 worker 中執行，因此您可以在此載入資源、資料庫或網路項目，而無須另外建立 worker。

API 變更

• 為 Button、Checkbox、RadioButton 和 Switch 新增 *Defaults API。這可讓 Glance 更符合 Jetpack Compose 的模式。(I94828)。
• 新版 Glance 範本模組 (I94459)
• 將 ResourceColorProvider 設為模組內部。破壞性變更。這是必要的，因為 ResourceColorProvider 應只用於動態主題設定，以免部分顏色為動態資源，而部分顏色則已完全解析。(Ib0db7)。
• 將 FontFamily 新增為 TextStyle 的選項。(Ic19ba、b/274179837)。
• Enum.valueOf 的值參數名稱已變更 (Ia9b89)
• 從 valueOf 列舉擲回的更多例外狀況 (I818fe)
• 已更新 GlanceAppWidget，以便使用 provideGlance 做為主要進入點。GlanceAppWidget.Content 現已淘汰 (I202b5)。
• 新增選項，可為圖片提供色調顏色 (I26192、b/212418562)
• 更多已淘汰隱藏函式的傳回類型為空值。(Ibf7b0)。
• 新增 @JvmDefaultWithCompatibility 註解 (I8f206)
• 移除未使用的 SingleEntityTemplateData.displayHeader。(I7f094)。
• 新增支援使用 lambda 做為回呼 (Ia0bbd)
• 將 DayNightColorProvider 移至 Glance 模組 (I1842c、b/256934779)
• 從範本中移除 LocalColorProvider。範本現在會使用 GlanceTheme.colors (Ic15e2)
• 已從 Text(style: TextStyle) 中移除可為空值性 (I7123b、b/237012816)
• 將預設文字顏色設為黑色。移除可空值性 (I3072c、b/237012816)。
• 將動態主題 ColorProviders 設為專屬物件。將 ResourceColorProvider 設為模組內部。(Id0e2d、b/237012816)。
• 將「未定義」類別新增至 ImageSize。(I2fa39)
• 移除已淘汰的 GlanceAppWidget.Content 函式 (Ib05f6)
• 將修飾符新增為 AndroidRemoteViews 的參數。(I515d4)。
• 新增 GlanceAppWidget.compose，讓單元測試更輕鬆 (Ie9b28)

修正錯誤

• 新增 Glance 文字字型的示範小工具 (I5c3d7)
• 讓 AndroidRemoteViews 可透過 Modifier 調整大小。
• 解決主題顏色不一致的問題
• 所有資源現在都會加上前置字串，以免發生衝突

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) 更新核心和應用程式是否可為空值的作法
• 在 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，並引入預設使用 Preferences 的 updateAppWidgetState。(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 圖塊服務，這是用來在可組合項 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，以及一組為「可瀏覽」最佳化的新的可組合項。

功能

• 透過 GlanceAppWidget 和 GlanceAppWidgetReceiver 宣告應用程式小工具。
• 使用初始「瀏覽」可組合項建構 UI：方塊、列、欄、文字內容、按鈕、延遲欄、圖片、空格。
• 使用 GlanceModifier 方法對可組合元素套用修飾符。
• 使用預先定義的動作處理使用者互動。
  • actionStartActivity
  • actionRunCallback
  • actionStartService
  • actionStartBroadcastReceiver
• 使用 ActionParameters 為動作提供參數。
• 處理不同大小模式的方法是，定義 SizeMode.Single、SizeMode.Exact 或 SizeMode.Responsive。
• 透過提供 GlanceStateDefinition，保留 GlanceAppWidget 狀態。
• 本地組合，例如 LocalContext、LocalState、LocalGlanceId、LocalSize。
• 與現有的 RemoteViews 以及 AndroidRemoteViews 可組合元素互通。