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