Resolver problemas com links de apps

Este guia descreve problemas comuns e como resolvê-los. Você também pode usar as ferramentas de solução de problemas na página de links diretos do Play Console ou no assistente de App Links do Android Studio. Para mais informações, consulte Ferramentas para desenvolvedores de Links do app.

  • Problema: você clica em um link que deveria abrir seu app, mas ele abre em um navegador da Web ou mostra uma caixa de diálogo de desambiguação.
  • Solução:
    • Verifique assetlinks.json: confira se o arquivo é JSON válido, acessível em https://<your-domain>/.well-known/assetlinks.json e veiculado por HTTPS sem redirecionamentos. Use um validador on-line.
    • Verifique a impressão digital SHA-256: confira se o sha256_cert_fingerprints em assetlinks.json corresponde exatamente à impressão digital da chave de assinatura da versão do app. Use a do Play Console se você usa a Assinatura de apps do Google Play. A assinatura precisa estar em maiúsculas.
    • Verifique autoVerify: confira se o <intent-filter> no seu AndroidManifest.xml inclui android:autoVerify="true".
    • Verifique se há redirecionamentos do lado do servidor: redirecionamentos de http para https ou de um domínio sem www para www podem causar falha na verificação.
    • Forçar a nova verificação: execute os comandos adb no guia Testar links de apps para receber um novo resultado de verificação.

As regras dinâmicas no Android 15 e versões mais recentes não estão sendo atualizadas

  • Problema: você atualizou as regras no arquivo assetlinks.json, mas o app não está processando os novos links.
  • Solução:
    • Forçar a nova verificação: a maneira mais confiável de testar mudanças é forçar uma nova busca com adb shell pm verify-app-links --re-verify. <your-package-name>.
    • Verifique se há erros de digitação: revise cuidadosamente os comparadores de padrões nas regras para verificar se há erros de sintaxe.
    • Verifique as regras de filtro do manifesto: revise as regras de filtro de intent no manifesto do app para garantir que o caminho do link não esteja sendo filtrado. Se o link estiver sendo filtrado, torne o filtro de intent no manifesto do app menos restritivo.

Corrigir erros comuns de implementação

Se você não conseguir verificar os links do app Android, confira os seguintes erros comuns: Esta seção usa example.com como um nome de domínio substituto. Ao realizar essas verificações, substitua example.com pelo nome de domínio real do seu servidor.

Configuração incorreta do filtro de intent
Verifique se você incluiu um URL que não pertence ao seu app em um elemento <intent-filter>.
Configuração incorreta do servidor

Verifique a configuração JSON do servidor e confira se o valor SHA está correto.

Além disso, verifique se example.com. (com o ponto final) veicula o mesmo conteúdo que example.com.

Redirecionamentos do lado do servidor

O sistema não verifica nenhum Link do app Android para seu app se você configurar um redirecionamento como este:

  • http://example.com a https://example.com
  • example.com a www.example.com

Esse comportamento protege a segurança do app.

Robustez do servidor

Verifique se os apps clientes podem se conectar ao servidor.

Links não verificáveis

Para fins de teste, você pode adicionar links não verificáveis intencionalmente. No Android 11 e versões anteriores, esses links fazem com que o sistema não verifique todos os Links do app Android do seu app.

Assinatura incorreta em assetlinks.json

Verifique se a assinatura está correta e corresponde à usada para assinar o app. Erros comuns incluem:

  • Assinar o app com um certificado de depuração e ter apenas a assinatura de lançamento em assetlinks.json.
  • Ter uma assinatura em minúsculas em assetlinks.json. A assinatura precisa estar em maiúsculas.
  • Se você estiver usando a Assinatura de apps do Google Play, confira se está usando a assinatura que o Google usa para assinar cada uma das suas versões. Para verificar esses detalhes, incluindo um snippet JSON completo, siga as instruções sobre declaração de associações de sites.