Visão geral dos atalhos de apps

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 assistente compatível e ajudar os usuários a iniciar rapidamente tarefas comuns ou recomendadas no seu 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

Principais ações mostradas usando atalhos de apps
Figura 1. Com atalhos de apps, é possível mostrar as principais ações e levar o usuário para dentro do seu app instantaneamente.

Cada atalho faz referência a uma ou mais intents, cada uma delas inicia uma ação específica no seu app quando os usuários selecionam o atalho. Os tipos de atalhos criados para seu app dependem do caso de uso dele. Exemplos de ações que podem ser expressadas como atalhos incluem:

  • 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 o contato de um 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.

Você pode publicar os seguintes tipos de atalhos para seu app:

  • Os atalhos estáticos são definidos em um arquivo de recursos que é incluído em um APK ou pacote de apps.
  • Os atalhos dinâmicos só podem ser enviados, atualizados e removidos pelo seu app no momento da execução.
  • Os atalhos fixados podem ser adicionados a telas de início compatíveis no momento da execução, se o usuário permitir.

Exibir atalhos nos assistentes usando recursos

Os recursos no shortcuts.xml permitem que você declare os tipos de ações que os usuários podem realizar para iniciar o app e ir diretamente para a execução de 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 atalhos estáticos e dinâmicos. Ao enviar atalhos dinâmicos para exibição nas plataformas do Google, use a Biblioteca de integração do Google Shortcuts para não ficar sujeito ao limite de atalhos.

Se você optar por não usar a Biblioteca de integração do Google Shortcuts, seu app estará sujeito ao limite do dispositivo para o número de atalhos que ele oferece suporte por vez. Os atalhos publicados dessa forma só aparecem nas telas de início do Android e não podem ser descobertos 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. Seu app não pode remover atalhos fixados, mas pode desativar eles.

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 ShortcutManager documentação de referência da API.