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 Links diretos do Play Console ou no Assistente de Links do app 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 é aberto em um navegador da Web ou mostra uma caixa de diálogo de desambiguação.
  • Solução:
    • Verifique assetlinks.json: confira se o arquivo é um 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 seu app. Use a do Play Console se você usa a Assinatura de apps do Google Play. A assinatura precisa estar em letras 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 não www para www podem causar falha na verificação.
    • Forçar nova verificação: execute os comandos adb no guia Testar links do app 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 os novos links não estão sendo processados pelo app.
  • 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 correspondentes de padrão 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 domínio marcador. Ao realizar essas verificações, substitua example.com pelo nome de domínio real do seu servidor.

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

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

Além disso, confira 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 para https://example.com
  • example.com para www.example.com

Esse comportamento protege a segurança do seu 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.

Assinatura incorreta em assetlinks.json

Verifique se a assinatura está correta e corresponde à assinatura usada para assinar o app. Os 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 letras minúsculas em assetlinks.json. A assinatura precisa estar em letras maiúsculas.
  • Se você estiver usando a Assinatura de apps do Google Play, use a assinatura que o Google usa para assinar cada uma das suas versões. É possível verificar esses detalhes, incluindo um snippet JSON completo, seguindo as instruções sobre como declarar associações de sites.

Capturar um relatório de bugs

Para problemas complexos que são difíceis de reproduzir, capture um relatório de bugs e analise-o. Isso pode fornecer insights valiosos sobre o processo de verificação e erros no nível do sistema.