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,并引入了默认使用 PreferencesupdateAppWidgetState。(I58963)
  • 添加了 Glance TemplateText 类,并更新了模板设计 (I4e146)
  • 为 Freeform 模板添加了概要基础架构 (If03d6)
  • 更新了 SingleEntityTemplate 布局 (If925d)
  • 添加了 LazyVerticalGrid (I5f442)
  • SingleEntityTemplate 上使用 ColorProvider (I01ee0)
  • 更新了模板类名称 (I3720e)
  • 添加了 LinearProgressIndicatorCircularProgressIndicator 可组合项。(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 可组合项:CurvedRowCurvedText
  • 通过定义 TimelineMode.SingleEntryTimelineMode.TimeBoundEntries,处理图块的不同时间轴模式。
  • LocalTimeInterval,表示特定时间间隔的 Local 组合。
  • BorderModifer 是在元素周围应用边框的 GlanceModifier

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

API 变更

  • 添加了 LinearProgressIndicatorCircularProgressIndicator 可组合项。(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-alpha01androidx.glance:glance-appwidget:1.0.0-alpha01androidx.glance:glance-appwidget-proto:1.0.0-alpha01版本 1.0.0-alpha01 中包含这些提交内容

初始版本的功能

  • Glance 的第一个版本包含第一组使用 Compose Runtime 构建 AppWidget 的 API,以及一组针对“Glanceables”进行了优化的新可组合项。

功能