Como desenvolvedor, você pode definir atalhos para realizar ações específicas no seu app. É possível mostrar esses atalhos em uma tela de início ou um assistente compatível e ajudar os usuários a iniciar rapidamente tarefas comuns ou recomendadas no app.
Esta documentação mostra como criar e gerenciar atalhos de apps. Você também pode aprender algumas práticas recomendadas para melhorar seus atalhos.
Tipos de atalho
Cada atalho faz referência a uma ou mais intents, que iniciam uma ação específica no app quando os usuários selecionam o atalho. Os tipos de atalhos criados para o app dependem do caso de uso dele. Exemplos de ações que podem ser expressas como atalhos:
- Escrever um novo e-mail em um app de e-mails.
- Guiar os usuários até um determinado local em um app de mapas.
- Enviar mensagens para um contato do usuário em um app de comunicação.
- Assistir o próximo episódio de um programa de TV em um app de mídia.
- Carregar o último ponto salvo em um app de jogo.
- Permitir que o usuário peça uma bebida em um app de entrega usando comandos de voz.
É possível publicar os seguintes tipos de atalhos para seu app:
- Os atalhos estáticos são definidos em um arquivo de recursos empacotado em um APK ou pacote de app.
- Os atalhos dinâmicos podem ser enviados, atualizados e removidos pelo app apenas no momento da execução.
Os atalhos fixados podem ser adicionados a telas de início compatíveis no ambiente de execução se o usuário conceder permissão.
Exibir atalhos nos assistentes usando recursos
Os recursos em shortcuts.xml permitem declarar os tipos de ações que os usuários podem
realizar para iniciar o app e acessar uma tarefa específica. Para
mais detalhes, consulte a documentação sobre como adicionar recursos.
Limitações de atalhos
A maioria das telas de início compatíveis mostra até quatro atalhos por vez, incluindo os estáticos e os dinâmicos. Ao enviar atalhos dinâmicos para exibição nas plataformas do Google, use a biblioteca de integração do Google Shortcuts para evitar o limite de atalhos.
Se você optar por não usar a biblioteca de integração Google Shortcuts, seu app estará sujeito ao limite do dispositivo para o número de atalhos que ele aceita por vez. Os atalhos publicados dessa forma aparecem apenas nas telas de início do Android e não podem ser detectados em outras plataformas do Google.
Não há limite para o número de atalhos fixados que os usuários podem criar para seu app. O app não pode remover atalhos fixados, mas pode desativá-los.
Para começar a criar atalhos para seu app, consulte a seguinte documentação:
Para mais detalhes sobre as operações que podem ser realizadas em atalhos, consulte a
documentação de referência da API ShortcutManager.