Práticas recomendadas para atalhos

Ao projetar e criar os atalhos do seu app, siga estas diretrizes:

Siga as diretrizes de design

Para tornar os atalhos do seu app visualmente consistentes com os atalhos usados nos apps do sistema, siga as Diretrizes de design para atalhos de apps (em inglês).

Publicar somente quatro atalhos diferentes

Embora a API seja atualmente compatível com uma combinação de até 15 atalhos estáticos e dinâmicos para seu app a qualquer momento, recomendamos que você publique apenas quatro atalhos diferentes para melhorar a aparência na tela de início.

Além de exibir atalhos na tela de início, use a biblioteca de integração do Google Shortcuts para exibir atalhos em plataformas do Google, como o Google Assistente. Essa biblioteca é compatível com o envio de um número ilimitado de atalhos dinâmicos. Se você estiver usando essa biblioteca para enviar um grande número de atalhos, recomendamos definir a "classificação" dos atalhos que aparecem em telas de início compatíveis chamando o método setRank().

Limitar o tamanho da descrição do atalho

O espaço no menu que mostra os atalhos do seu app na tela de início é limitado. Quando possível, limite o tamanho da "descrição curta" do atalho a 10 caracteres e o tamanho da "descrição longa" a 25 caracteres.

Para ver mais informações sobre as etiquetas de atalhos estáticos, consulte Personalizar os valores de atributos. Para saber mais sobre atalhos dinâmicos e fixados, leia a documentação de referência sobre setLongLabel() e setShortLabel().

Manter o histórico de uso de atalhos e ações

Para cada atalho criado, considere as diferentes maneiras em que um usuário pode realizar a mesma tarefa diretamente no seu app. Lembre-se de chamar reportShortcutUsed() em cada uma dessas situações para que a tela de início mantenha um histórico preciso da frequência com que o usuário realiza as ações que representam seus atalhos.

Atualizar os atalhos apenas quando o significado deles for retido

Ao mudar atalhos dinâmicos e fixados, chame updateShortcuts() somente quando mudar as informações de um atalho que retém o significado. Caso contrário, use um dos métodos a seguir, dependendo do tipo de atalho que está sendo recriado:

Por exemplo, se você criou um atalho para navegar em um supermercado, seria apropriado atualizá-lo se o nome do supermercado mudar, mas o local permanecer o mesmo. No entanto, se o usuário começar a fazer compras em um supermercado diferente, o melhor seria criar um novo atalho.

Verificar os atalhos dinâmicos sempre que o app for iniciado

Os atalhos dinâmicos não são preservados quando o usuário restaura os dados em um novo dispositivo. Por esse motivo, recomendamos que você verifique o número de objetos retornados por getDynamicShortcuts() todas as vezes que o app for iniciado e publique os atalhos dinâmicos novamente conforme necessário, como mostrado no snippet de código em Backup e restauração.