Виджеты приложений можно настраивать. Например, виджет часов может позволить пользователям настроить, какой часовой пояс отображать.
Если вы хотите, чтобы пользователи могли настраивать виджет, создайте конфигурацию виджета Activity.
Объявите действие конфигурации
Объявление действия конфигурации в манифесте и его связывание внутри XML-метаданных поставщика идентичны как для виджетов приложений на основе представлений, так и для виджетов приложений на основе Glance.
Чтобы узнать, как объявить действие конфигурации, ознакомьтесь с разделом Объявление действия конфигурации в документации по конфигурации Glance.
Реализуйте действие конфигурации
Поскольку действия по настройке являются стандартными компонентами, вызываемыми средством запуска платформы, их основные обратные вызовы жизненного цикла должны соответствовать правилам возвращаемого значения системы.
Чтобы узнать, как реализовать действие конфигурации, ознакомьтесь с разделом Реализация действия конфигурации в документации по Glance.
Обновление виджета из действия конфигурации
В традиционных виджетах на основе Views вы обновляете виджет после завершения настройки, используя AppWidgetManager и экземпляр макета RemoteViews.
Если вы создаете устаревший виджет на основе представлений и вам нужно обновить макет RemoteViews, используйте образец кода для обновления представлений на GitHub. Для современных виджетов, созданных с помощью Compose, см. раздел Обновление из действия конфигурации в документации Glance.
Варианты конфигурации виджета
Поведение виджетов (например, возможность повторной настройки или пропуск начальных шагов настройки) регистрируется в атрибутах метаданных с помощью стандартных флагов Android 12.
Чтобы узнать, как использовать параметры динамического виджета, ознакомьтесь с разделом Параметры конфигурации виджета в документации по конфигурации Glance.
Разрешить пользователям изменять настройки размещенных виджетов
Чтобы узнать, как добавить настраиваемые триггеры для изменения конфигурации, ознакомьтесь с разделом Как разрешить пользователям изменять конфигурацию размещенных виджетов в документации по Glance.
Использовать конфигурацию виджета по умолчанию
Чтобы узнать, как пропускать настройку по умолчанию, ознакомьтесь с разделом Использование конфигурации виджета по умолчанию в документации Glance.