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
rankdos atalhos que precisam aparecer em telas de início compatíveis chamando o métodosetRank().- 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()esetShortLabel().- 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.