Glance

使用 Jetpack Compose 樣式 API,為遠端介面建立版面配置。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2022 年 2 月 23 日 - - - 1.0.0-alpha03

宣告依附元件

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

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

Groovy

dependencies {
    // For AppWidgets support
    implementation "androidx.glance:glance-appwidget:1.0.0-alpha03"

    // For Wear-Tiles support
    implementation "androidx.glance:glance-wear-tiles:1.0.0-alpha03"
}

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-alpha03")

    // For Wear-Tiles support
    implementation("androidx.glance:glance-wear-tiles:1.0.0-alpha03")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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

意見回饋

您的意見可協助我們改善 Jetpack。發現新的問題或有改善這個程式庫的想法時,請告訴我們。請先查看此程式庫中的現有問題,再提報新問題。只要按一下星號按鈕,即可投票給現有的問題。

提報新問題

詳情請參閱 Issue Tracker 文件

1.0.0 版本

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 執行階段透過為「可瀏覽」最佳化的可組合元素來建構 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 執行階段建立 AppSheet,以及一組為「可瀏覽」最佳化的新的可組合元素。

特色