Criar 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 de ícones para atalhos de apps.

Publicar somente 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 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 mostrar 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 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 seu 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 as etiquetas de atalhos estáticos, consulte Personalizar 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 de um usuário 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 da frequência com que um 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:

• Atalhos dinâmicos: pushDynamicShortcut().

• Atalhos fixados: requestPinShortcut().

  Por exemplo, se você criou um atalho para navegar em um supermercado, é adequado atualizar o atalho 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 atalhos dinâmicos novamente conforme necessário, como mostrado no snippet de código em Backup e restauração.