允许用户配置应用 widget

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

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

声明配置 activity

在清单中声明配置 Activity 并将其关联到提供方 XML 元数据中的方式,对于基于 View 的应用 widget 和基于 Glance 的应用 widget 都是相同的。

如需了解如何声明配置 activity,请参阅 Glance 配置文档中的“Compose-first”声明配置 activity 部分

实现配置 activity

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

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

通过配置 activity 更新 widget

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

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

widget 配置选项

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

如需了解如何利用动态 widget 选项,请参阅 Glance 配置文档中的“Compose-first widget 配置选项部分”。

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

如需了解如何添加自定义的可重新配置的设置触发器,请参阅 Glance 文档中的“Compose-first 允许用户重新配置已放置的 widget 部分”。

使用微件的默认配置

如需了解如何默认跳过配置设置,请参阅 Glance 文档中的“Compose-first”使用微件的默认配置部分