Glance

使用 Jetpack Compose 樣式 API，為遠端介面建立版面配置。
最新版 穩定版 候選版 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，以及一組為「可瀏覽」最佳化的新的可組合項。

特色