允许用户配置应用 widget

应用 widget 可以配置。例如,时钟 widget 可以让用户配置要显示的时区。

如果您想让用户配置 widget 的设置,请创建 widget 配置 Activity。

声明配置 activity

在清单中声明配置 activity 并在提供程序 XML 元数据中关联该 activity 的方式,在基于 View 的应用 widget 和基于 Glance 的应用 widget 中完全相同。

如需了解如何声明配置 activity,请参阅 Glance 配置文档中的 Compose 优先声明配置 activity 部分。

实现配置 activity

由于配置 activity 是由平台启动器调用的标准组件,因此其基本生命周期回调必须遵循系统的返回值规则。

如需了解如何实现配置 activity,请参阅 Glance 文档中的 Compose 优先实现配置 activity 部分。

通过配置 activity 更新 widget

在传统的基于 View 的 widget 中,您可以在配置完成后使用 AppWidgetManager 和 RemoteViews 布局实例更新 widget。

如果您要构建基于视图的旧版 widget,并且需要更新 RemoteViews 布局,请参阅 GitHub 上的传统视图更新示例代码。对于现代 Compose 优先微件,请参阅 Glance 文档中的通过配置 activity 部分进行更新。

微件配置选项

微件行为(例如允许稍后重新配置或完全跳过初始配置设置步骤)会使用标准 Android 12 标志在元数据属性中注册。

如需了解如何利用动态 widget 选项,请参阅 Glance 配置文档中 Compose 优先的微件配置选项部分。

允许用户重新配置已放置的微件

如需了解如何添加自定义可重新配置的设置触发器,请参阅 Glance 文档中 Compose 优先的让用户能够重新配置已放置的地点微件部分。

使用微件的默认配置

如需了解如何默认跳过配置设置,请参阅 Glance 文档中的 Compose 优先使用 widget 的默认配置部分。