Los widgets de la app se pueden configurar. Por ejemplo, un widget de reloj puede permitir que los usuarios configuren qué zona horaria mostrar.
Si quieres permitir que los usuarios configuren los parámetros de configuración 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 del proveedor es idéntico en los widgets de la app basados en Views y en Glance.
Para obtener información sobre cómo declarar la actividad de configuración, consulta la sección sobre cómo declarar la actividad de configuración 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 a los que llama el selector de la plataforma, sus devoluciones de llamada básicas del ciclo de vida deben seguir las reglas de valores de devolución del sistema.
Para obtener información sobre cómo implementar una actividad de configuración, consulta la sección Implementa la actividad de configuración en la documentación de Glance.
Actualiza el widget desde la actividad de configuración
En los widgets tradicionales basados en Views, actualizas el widget cuando se completa la configuración con AppWidgetManager y una instancia de diseño RemoteViews.
Si compilas un widget heredado basado en Views y necesitas actualizar el diseño de RemoteViews, consulta el código de muestra de actualización de Views tradicional en GitHub. Para los widgets modernos que priorizan Compose, consulta la sección Actualización 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 iniciales de configuración) se registran dentro de los atributos de metadatos con marcas estándar de Android 12.
Para obtener información sobre cómo aprovechar las opciones de widgets dinámicos, consulta la sección 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 personalizados reconfigurables, consulta la sección Cómo permitir 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 obtener información sobre cómo omitir la configuración de forma predeterminada, consulta la sección Cómo usar la configuración predeterminada del widget de Compose-first en la documentación de Glance.