Os widgets de apps podem ser configuráveis. Por exemplo, um widget de relógio pode permitir que os usuários configurem qual fuso horário mostrar.
Se você quiser permitir que os usuários definam as configurações do widget, crie uma configuração de widget
Activity.
Declarar a atividade de configuração
A declaração da atividade de configuração no manifesto e a vinculação dela nos metadados XML do provedor são idênticas nos widgets de apps baseados em visualizações e no Glance.
Para saber como declarar a atividade de configuração, consulte a seção Declarar a atividade de configuração na documentação de configuração do Glance.
Implementar a atividade de configuração
Como as atividades de configuração são componentes padrão chamados pelo inicializador da plataforma, os callbacks básicos do ciclo de vida precisam seguir as regras de valor de retorno do sistema.
Para saber como implementar uma atividade de configuração, consulte a seção Implementar a atividade de configuração na documentação do Glance.
Atualizar o widget na atividade de configuração
Em widgets tradicionais baseados em visualizações, você atualiza o widget após a conclusão da configuração
usando o AppWidgetManager e uma instância de layout RemoteViews.
Se você estiver criando um widget legado baseado em visualizações e precisar atualizar o layout de RemoteViews, consulte o exemplo de código de atualização de visualizações tradicional no GitHub. Para widgets modernos que priorizam o Compose, consulte a seção Atualizar na atividade de configuração na documentação do Resumo.
Opções de configuração do widget
Os comportamentos do widget (como permitir a reconfiguração posterior ou pular as etapas de configuração inicial) são registrados em atributos de metadados usando flags padrão do Android 12.
Para saber como aproveitar as opções de widgets dinâmicos, consulte a seção de opções de configuração de widgets que priorizam o Compose na documentação de configuração do Glance.
Permitir aos usuários reconfigurar widgets colocados
Para entender como adicionar acionadores de configuração reconfiguráveis personalizados, consulte a seção Permitir que os usuários reconfigurem widgets posicionados na documentação do Glance.
Usar a configuração padrão do widget
Para saber como pular as definições de configuração por padrão, consulte a seção Usar a configuração padrão do widget na documentação do Glance.