Aprimorar seu widget

Este guia inclui detalhes sobre melhorias opcionais de widgets que são simples de implementar e melhoram a experiência do usuário com widgets.

Adicionar um nome ao widget

Os widgets precisam ter um nome exclusivo quando são exibidos no seletor de widgets.

Os nomes dos widgets são carregados do atributo label do elemento receiver do widget no arquivo AndroidManifest.xml.

<receiver
    ….
   android:label="Memories">
     ….
</receiver>

Adicionar uma descrição ao widget

No Android 12 e versões mais recentes, forneça uma descrição para o seletor de widgets exibir para o widget.

Figura 1. Exemplo de seletor de widgets mostrando um widget e a descrição dele.

Forneça uma descrição para o widget usando o description atributo do <appwidget-provider> elemento:

<appwidget-provider
    android:description="@string/my_widget_description">
</appwidget-provider>

Observação: seja conciso. Não há limite de caracteres, mas a representação e o espaço disponível para a descrição podem variar dependendo do dispositivo.

Você pode usar o descriptionRes atributo em versões anteriores do Android, mas ele é ignorado pelo seletor de widgets.