Criar atalhos

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

Siga as diretrizes de design
Para que os atalhos do seu app sejam visualmente consistentes com os usados para apps do sistema, siga as Diretrizes de design de ícones de atalhos de apps.
Publicar apenas quatro atalhos diferentes

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

Além de mostrar atalhos na tela de início, use a biblioteca de integração do Google Shortcuts para mostrar atalhos em plataformas do Google, como o Google Assistente. Essa biblioteca oferece suporte ao 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 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 no menu que mostra 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 para atalhos estáticos, leia Personalizar valores de atributos. 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 que um usuário pode realizar a mesma tarefa diretamente no app. Chame reportShortcutUsed() em cada uma dessas situações para que o acesso rápido mantenha um histórico preciso da frequência com que um usuário realiza as ações que representam seus atalhos.

Atualizar atalhos apenas quando o significado deles for mantido

Ao mudar atalhos dinâmicos e fixados, chame updateShortcuts() apenas ao mudar as informações de um atalho que manté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, será adequado 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 outro supermercado, é melhor criar um novo atalho.

Verificar os atalhos dinâmicos sempre que você iniciar o app
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() sempre que iniciar o app e publique novamente os atalhos dinâmicos conforme necessário, como mostrado no snippet de código em Backup e restauração.