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 referencia uma ou mais intents, e cada uma delas inicia uma ação específica no seu app quando o usuário seleciona 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 um 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 falados.

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

Com os recursos em shortcuts.xml, você declara os tipos de ações que os usuários podem realizar para iniciar o app e ir direto para 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 exibe 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 vai estar sujeito ao limite do dispositivo para o número de atalhos que ele pode ter por vez. Os atalhos publicados dessa forma só aparecem nos inicializadores 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. 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 operações que podem ser realizadas em atalhos, consulte a documentação de referência da API ShortcutManager.