Glance
最近更新时间 | 稳定版 | 候选版本 | 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”进行了优化的新可组合项。
功能
- 使用 GlanceAppWidget 和 GlanceAppWidgetReceiver 声明您的应用 widget。
- 使用最初的一组 Glance 可组合项编写界面:Box、Row、Column、Text、Button、LazyColumn、Image、Spacer。
- 使用 GlanceModifier 方法将修饰符应用于可组合项。
- 处理与预定义的 Action 之间的用户交互。
- 使用 ActionParameters 向 Action 提供参数。
- 通过定义 SizeMode.Single、SizeMode.Exact 或 SizeMode.responsive 来处理不同的尺寸模式。
- 通过提供 GlanceStateDefinition 保留 GlanceAppWidget 状态。
- 本地组合(如 LocalContext、LocalState、LocalGlanceId、LocalSize)。
- 使用 AndroidRemoteViews 可组合项与现有的 RemoteViews 互操作。