Glance

使用 Jetpack Compose 样式的 API 构建远程 Surface 的布局。
最近更新时间 稳定版 候选版本 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"
    }
}

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库的改进有自己的见解，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

版本 1.0.0

版本 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)
  • 为 Freeform 模板添加了概要基础架构 (If03d6)
  • 更新了 SingleEntityTemplate 布局 (If925d)
  • 添加了 LazyVerticalGrid (I5f442)
  • 在 SingleEntityTemplate 上使用 ColorProvider (I01ee0)
  • 更新了模板类名称 (I3720e)
  • 添加了 LinearProgressIndicator 和 CircularProgressIndicator 可组合项。(Ie116b)

bug 修复

  • 实现了初始 Glance 模板，定义了“单项模板”数据和示例模板布局 (I35837)
  • 默认情况下，对图块内容进行中心对齐 (I264be)
  • 修复了 glance-wear-tiles 中的 fillMaxSize/Width/Height 存在的 bug (I0a39f)

版本 1.0.0-alpha02

2022 年 1 月 26 日

发布了 androidx.glance:glance-*:1.0.0-alpha02。版本 1.0.0-alpha02 中包含这些提交内容。

新功能

此版本包含一组 API，这些 API 用于使用具有可组合项（针对“支持 Glance”进行过优化）的 Compose 运行时构建穿戴式设备图块

  • 通过扩展 GlanceTileService（用于在可组合 Content() 函数中创建图块的服务）来声明穿戴式设备图块服务。
  • 穿戴式设备图块专用 Glance 可组合项：CurvedRow、CurvedText。
  • 通过定义 TimelineMode.SingleEntry 和 TimelineMode.TimeBoundEntries，处理图块的不同时间轴模式。
  • LocalTimeInterval，表示特定时间间隔的 Local 组合。
  • BorderModifer 是在元素周围应用边框的 GlanceModifier。

此版本还向 AppWidget Glance 添加了进度指示器。

API 变更

  • 添加了 LinearProgressIndicator 和 CircularProgressIndicator 可组合项。(Ie116b)
  • 将 actionStartBroadcastReceiver 更改为 actionSendBroadcast (I7d555)
  • 将 Context 传递给 GlanceAppWidget onDelete 回调 (I4c795)

bug 修复

  • 当 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 的第一个版本包含第一组使用 Compose Runtime 构建 AppWidget 的 API，以及一组针对“Glanceables”进行了优化的新可组合项。

功能