Aprimorar seu widget

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

Adicione um nome ao widget

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

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

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

Adicionar uma descrição ao widget

A partir do Android 12, forneça uma descrição para o seletor de widgets mostrar no seu 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 atributo description do elemento <appwidget-provider>:

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

Observação :use um texto conciso. Não há limite de caracteres, mas a representação e o espaço disponível para a descrição podem variar de acordo com o dispositivo.

É possível usar o atributo descriptionRes em versões anteriores do Android, mas ele é ignorado pelo seletor de widgets.