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()
esetShortLabel()
. - 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:- Atalhos dinâmicos:
pushDynamicShortcut()
. - Atalhos fixados:
requestPinShortcut()
.
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.
- Atalhos dinâmicos:
- 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.