Los widgets de la app se pueden configurar. Por ejemplo, un widget de reloj puede permitir que los usuarios configuren qué zona horaria se mostrará.
Si quieres permitir que los usuarios configuren los parámetros de tu widget, crea una Activity de configuración del widget.
Declara la actividad de configuración
Declarar la actividad de configuración en el manifiesto y vincularla dentro de los metadatos XML de tu proveedor es idéntico en los widgets de la app basados en vistas y en Glance.
Para aprender a declarar la actividad de configuración, consulta la sección Declara la actividad de configuración de Compose-first en la documentación de configuración de Glance.
Implementa la actividad de configuración
Debido a que las actividades de configuración son componentes estándar que llama el selector de la plataforma, sus devoluciones de llamada de ciclo de vida básicas deben seguir las reglas de valor de retorno del sistema.
Para aprender a implementar una actividad de configuración, consulta la sección Implementa la actividad de configuración de Compose-first en la documentación de Glance.
Actualiza el widget desde la actividad de configuración
En los widgets tradicionales basados en vistas, actualizas el widget cuando se completa la configuración con AppWidgetManager y una instancia de diseño RemoteViews.
Si estás compilando un widget heredado basado en vistas y necesitas actualizar el diseño de RemoteViews, consulta el código de muestra de actualización de vistas tradicional en GitHub. Para ver los widgets modernos que priorizan Compose, consulta la sección Actualiza desde la actividad de configuración en la documentación de Glance.
Opciones de configuración del widget
Los comportamientos de los widgets (como permitir la reconfiguración más adelante o omitir por completo los pasos de configuración inicial) se registran dentro de los atributos de metadatos con las marcas estándar de Android 12.
Para aprender a aprovechar las opciones de widgets dinámicos, consulta la sección de opciones de configuración de widgets de Compose-first en la documentación de configuración de Glance.
Cómo permitir que los usuarios reconfiguren los widgets colocados
Para comprender cómo agregar activadores de configuración reconfigurables personalizados, consulta la sección Permite que los usuarios reconfiguren los widgets colocados de Compose-first en la documentación de Glance.
Cómo usar la configuración predeterminada del widget
Para aprender a omitir los parámetros de configuración de forma predeterminada, consulta la sección Usa la configuración predeterminada del widget de Compose-first en la documentación de Glance.