应用 widget 可以配置。例如,时钟 widget 可以让用户配置要显示的时区。
如果您想让用户配置 widget 的设置,请创建 widget 配置 Activity。
声明配置 activity
在清单中声明配置 Activity 并将其关联到提供程序 XML 元数据中的方式,对于基于 View 的应用微件和基于 Glance 的应用微件都是相同的。
如需了解如何声明配置 activity,请参阅 Glance 配置文档中的“Compose-first”声明配置 activity 部分。
实现配置 activity
由于配置 activity 是由平台启动器调用的标准组件,因此其基本生命周期回调必须遵循系统的返回值规则。
如需了解如何实现配置 activity,请参阅 Glance 文档中的“实现配置 activity”部分(Compose-first)。
通过配置 activity 更新 widget
在基于传统 View 的 widget 中,您可以使用 AppWidgetManager 和 RemoteViews 布局实例在配置完成后更新 widget。
如果您要构建基于旧版视图的小部件,并且需要更新 RemoteViews 布局,请参阅 GitHub 上的传统视图更新示例代码。对于以 Compose 为主的新式 widget,请参阅 Glance 文档中的从配置 activity 进行更新部分。
widget 配置选项
微件行为(例如允许稍后重新配置或完全跳过初始配置设置步骤)使用标准 Android 12 标志在元数据属性内注册。
如需了解如何利用动态 widget 选项,请参阅 Glance 配置文档中的“Compose-first widget 配置选项部分”。
允许用户重新配置已放置的微件
如需了解如何添加自定义可重新配置的设置触发器,请参阅 Glance 文档中的“Compose-first 允许用户重新配置已放置的 widget 部分”。
使用微件的默认配置
如需了解如何默认跳过配置设置,请参阅 Glance 文档中的“Compose-first”使用微件的默认配置部分。