Práticas recomendadas para atalhos

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

Seguir 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 do ícone para atalhos de apps.

Publicar apenas quatro atalhos diferentes

Embora a API ofereça suporte a uma combinação de até 15 atalhos estáticos e dinâmicos para o app, 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 Google Shortcuts para exibir atalhos nas plataformas do Google, como o Google Assistente. Essa biblioteca oferece suporte ao envio de um número ilimitado de atalhos dinâmicos. Se você está usando essa biblioteca para enviar um grande número de atalhos, recomendamos definir o rank dos atalhos que precisam aparecer em telas de início compatíveis chamando o método setRank().

Limitar o tamanho da descrição do atalho

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

Para mais informações sobre rótulos de atalhos estáticos, leia Personalizar valores de atributo. Para 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 como um usuário pode realizar a mesma tarefa diretamente no seu app. Chame reportShortcutUsed() em cada uma dessas situações para que a tela de início mantenha um histórico preciso com que frequência um usuário realiza as ações que representam seus atalhos.

Atualizar atalhos apenas quando o significado deles for retido

Ao mudar atalhos dinâmicos e fixados, chame updateShortcuts() apenas ao 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 você está recriando:

• Atalhos dinâmicos: pushDynamicShortcut().
• Atalhos fixados: requestPinShortcut().

Por exemplo, se você criar um atalho para navegar até um supermercado, convém atualizar o atalho se o nome do supermercado mudar, mas o local dele permanecer o mesmo. No entanto, se o usuário começar a fazer compras em um supermercado diferente, é melhor 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 isso, recomendamos que você verifique o número de objetos retornados por getDynamicShortcuts() sempre que iniciar o app e publique os atalhos dinâmicos novamente conforme necessário, conforme mostrado no snippet de código em Backup e restauração.