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 quiser permitir que os usuários configurem as configurações do widget, crie uma
configuração de widget Activity.
Declarar a atividade de configuração
Declarar a atividade de configuração no manifesto e vinculá-la aos metadados XML do provedor é idêntico nos widgets de app baseados em Views e em Glance.
Para saber como declarar a atividade de configuração, consulte a seção Declarar a atividade de configuração da 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 iniciador 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 da documentação do Glance.
Atualizar o widget pela atividade de configuração
Nos widgets tradicionais baseados em Views, 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 Views e precisar atualizar o layout RemoteViews, consulte o exemplo de código tradicional de atualização de Views no GitHub. Para widgets modernos do Compose, consulte a seção Atualizar da atividade de configuração na documentação do Glance.
Opções de configuração de widgets
Os comportamentos do widget (como permitir a reconfiguração mais tarde ou pular as etapas iniciais de configuração) são registrados em atributos de metadados usando flags padrão do Android 12.
Para saber como aproveitar as opções de widget dinâmico, consulte a seção Opções de configuração de widget da documentação de configuração do Glance.
Permitir aos usuários reconfigurar widgets colocados
Para entender como adicionar gatilhos de configuração reconfiguráveis personalizados, consulte a seção Permitir que os usuários reconfigurem widgets colocados do Compose-first na documentação do Glance.
Usar a configuração padrão do widget
Para saber como pular as configurações por padrão, consulte a seção Usar a configuração padrão do widget da documentação do Glance.