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-alpha05androidx.glance:glance-appwidget:1.0.0-alpha05androidx.glance:glance-wear-tiles:1.0.0-alpha051.0.0-alpha05 版本包含以下修訂項目。

新功能

  • requestPinGlanceAppWidget 新增至 GlanceAppWidgetManager,讓應用程式提示使用者將 Glance 型小工具新增至主畫面。(Ic6e47)
  • ACTION_DEBUG_UPDATE 新增至 GlanceAppWidgetReceiver,讓開發人員強制要求小工具從已解鎖裝置和模擬器的 ADB 中更新。(I94ae1)

API 變更

  • 移除 Glance 範本中的標頭動作按鈕,藉此簡化用途。(Ie4387)
  • 重構單一實體範本,以便重複使用區塊子系統設計。(Iecd2c)
  • 重構 Glance 清單範本,以便使用 Text/Image/Action 區塊設計。(If0cc1)
  • 新增 TextBlockImageBlock 的優先順序值範圍。(I73100)

修正錯誤

  • 已移除 Material3 依附元件。(I28d1c)
  • 改用更加一致的系統,在 Glance 範本版面配置中增加邊界和間距。(I29773)
  • 修正格式錯誤的 Proguard 規則,以免導致無法建構壓縮版本。

1.0.0-alpha04 版本

2022 年 8 月 10 日

發布了 androidx.glance:glance:1.0.0-alpha04androidx.glance:glance-appwidget:1.0.0-alpha04androidx.glance:glance-wear-tiles:1.0.0-alpha041.0.0-alpha04 版本包含以下修訂項目。

新功能

  • 新增按鈕顏色功能。
  • 新增 GlanceComposable 註解,以改善編譯時間檢查。
  • 新增 Wear 專屬 Glance 功能。

API 變更

  • 更新 Glance Gallery Data API 和精簡檢視 (Ibc7a8)。
  • 新增 ButtonColors 以設定按鈕 (Iea88db/236305351)。
  • ColorProvider.resolve 重新命名為 ColorProvider.getColor (Ic9dfe)
  • copy() 方法新增至 TextStyle (I9aef6)。
  • 新增 ColorProviders 類別,可做為 Glance 主題的一部分 (I848b9b/237012816)。
  • 為清單樣式和收合的檢視畫面新增清單範本支援 (I50cdc)。
  • GlanceModiierGlanceCurvedModifier 中新增語意 (Ifda7e)。
  • 新增 GlanceComposable 註解 (I5dbf0)。
  • 將 Glance 範本移至主要的 Glance 專案 (I9db94)。
  • 新增 ColorProvider.resolve() (Ife532b/214733442)
  • 從現有 appWidgetId 或設定活動中的意圖取得 GlanceId 的新方法 (Icb70cb/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 圖塊中一併新增 curvedLinecurvedSpacer,並轉換為 ArcLineArcSpacer (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-alpha031.0.0-alpha03 版本包含以下修訂項目。

新功能

  • 將狀態定義簡化為「偏好設定」。

API 變更

  • PreferencesGlanceStateDefinition 設為預設狀態處理,藉此簡化狀態處理。移除了 GlanceAppWidget.updateAppWidgetState 及引入 updateAppWidgetState,其預設使用 Preferences (I58963)。
  • 新增 Glance TemplateText 類別,及更新範本設計 (I4e146)
  • 為任意形式的範本新增概述架構 (If03d6)
  • 更新至 SingleEntityTemplate 版面配置 (If925d)
  • 新增了 LazyVerticalGrid (I5f442)
  • SingleEntityTemplate 上使用 ColorProvider (I01ee0)
  • 更新範本類別名稱 (I3720e)
  • 新增了 LinearProgressIndicatorCircularProgressIndicator 可組合項 (Ie116b)。

修正錯誤

  • 初始化 glance 範本實作,定義「單一項目範本」資料及範例範本版面配置 (I35837)
  • 根據預設,將設定方塊內容置中對齊 (I264be)
  • 修正 glance-wear-圖塊中的 fillMaxSize/Width/Height 錯誤 (I0a39f)

1.0.0-alpha02 版本

2022 年 1 月 26 日

發布了 androidx.glance:glance-*:1.0.0-alpha021.0.0-alpha02 版本包含以下修訂項目。

新功能

這個版本包含一組 API,可以使用 Compose 執行階段透過「Glanceable」的最佳化可組合項來建構 Wear 圖塊

  • 透過擴充 GlanceTileService 以宣告 Wear 圖塊服務,這是用來在 Composable Content() 函式中建立圖塊的服務。
  • 特定於瀏覽的 Wear 圖塊的可組合項:CurvedRowCurvedText
  • 定義 TimelineMode.SingleEntryTimelineMode.TimeBoundEntries,以處理不同的圖塊時間軸模式。
  • LocalTimeInterval,本機組合是指特定時間間隔。
  • BorderModifer 是一個 GlanceModifier,會在元素周圍套用框線。

這個版本也會為 AppWidget Glance. 新增進度指標。

API 變更

  • 新增了 LinearProgressIndicatorCircularProgressIndicator 可組合項 (Ie116b)。
  • actionStartBroadcastReceiver 變更為 actionSendBroadcast (I7d555)
  • 將結構定義傳送至 GlanceAppWidget onDelete 回呼 (I4c795)

修正錯誤

  • 正確處理 OPTIONS_APPWIDGET_SIZES (如有且為空) (I01f82)。

1.0.0-alpha01 版本

2021 年 12 月 15 日

發布了 androidx.glance:glance:1.0.0-alpha01androidx.glance:glance-appwidget:1.0.0-alpha01androidx.glance:glance-appwidget-proto:1.0.0-alpha011.0.0-alpha01 版本包含這些修訂版本。

初始版本中的功能

  • 第一版 Glance 提供第一組 API,用以使用 Compose Runtime 建立 AppWidget,以及一組為「可瀏覽」最佳化的新的可組合項。

特色