Desenvolvimento Android

validar Android App Links · Confira a associação antes de publicar

Cole assetlinks.json, informe opcionalmente o pacote e o SHA-256 do certificado de assinatura e execute a verificação.

validar Android App Links

Entrada de assetlinks.json

Resultado local

Cole assetlinks.json ou carregue o exemplo.

Lista de implantação

Estes itens não foram medidos pela análise local.

  • Servir /.well-known/assetlinks.json via HTTPS em cada host, com application/json e sem redirecionamento.
  • Comparar o SHA-256 do certificado de assinatura no Play Console; incluir outras chaves só quando necessário.
  • Conferir autoVerify, host e caminhos do filtro web no manifesto.
  • Consultar adb shell pm get-app-links num aparelho instalado e verificar novamente após mudanças.

JSON, pacote e impressão digital são analisados nesta aba; nenhum domínio é contatado.

Opções

Cole assetlinks.json ou carregue o exemplo.

Um Link do App que abre no navegador pode ter JSON válido, mas nenhuma declaração para a instalação correta. Para validar Android App Links, a relação, o pacote e a impressão digital do certificado precisam estar na mesma declaração.

A ferramenta ajuda antes da publicação e ao investigar Links do App que falham. Ela identifica uma impressão digital SHA-256 divergente; a resposta HTTPS e a verificação real no aparelho exigem testes separados.

Por que validar Android App Links aqui

Uma declaração local compatível não comprova a verificação no aparelho.

Uma declaração precisa conter tudo

Ao validar Android App Links, o pacote de uma entrada não é combinado com o certificado de outra. handle_all_urls, pacote e SHA-256 precisam corresponder no mesmo alvo android_app.

Uma declaração liga relação, pacote e impressão digital; duas declarações separadas não formam uma correspondência.

Pendências de publicação visíveis

Este recurso para validar Android App Links não acessa o domínio. HTTPS, caminho fixo, tipo JSON, redirecionamentos, autoVerify e estado do aparelho permanecem como tarefas distintas, sem marcação falsa de sucesso.

Relatório JSON local ao lado de uma lista separada de verificações do servidor e do dispositivo Android.

Escolha a assinatura certa e releia o resultado

01

Identifique o certificado instalado

Com o Play App Signing, use o SHA-256 do certificado de assinatura do app no Play Console. A chave de upload ou de depuração pode ser diferente. O campo aceita 64 caracteres hexadecimais sem dois-pontos.

02

Execute após a última edição

A verificação é manual e aceita Ctrl/Cmd+Enter. Mudanças no JSON, no pacote ou na impressão digital tornam o relatório antigo desatualizado e bloqueiam cópia e download. Erros de sintaxe mostram linha e coluna.

03

Separe três resultados

Estrutura DAL válida, declaração correspondente e Link do App verificado no dispositivo são conclusões diferentes. include não é buscado. O arquivo exportado guarda todos os itens, embora a tela mostre grupos de 50.

Estrutura, relação e certificado em detalhe

Campos DAL com localização

Verificar assetlinks.json cobre o array raiz, relation e alvos android_app e web. Problemas trazem índice e caminho do campo; include permitido fica pendente, sem ser classificado como declaração inválida.

Comparação de SHA-256

A entrada esperada aceita letras maiúsculas ou minúsculas e dois-pontos opcionais. O formato do arquivo recebe aviso separado; SHA-1 e hash do JSON não substituem o certificado de assinatura.

Autorização por declaração

A relação handle_all_urls só corresponde quando pacote e impressão digital esperados estão na mesma entrada. Outras relações Digital Asset Links aparecem, sem conceder autorização de App Links.

Relatório completo

Copie ou baixe o resultado JSON atual. Listas grandes são exibidas em blocos de 50, mas o arquivo mantém todas as declarações e observações.

O que a análise local não comprova

Sem teste do servidor
A página não busca domínios nem mede tipo de resposta ou redirecionamentos. Confira a resposta HTTPS real em /.well-known/assetlinks.json para cada host usado pelo app.
Sem adivinhar a assinatura
A impressão digital esperada é opcional, mas sem ela nenhum certificado específico é confirmado. É preciso o SHA-256 do certificado que assina o aplicativo, não hash do arquivo, APK ou SHA-1.
include e regras dinâmicas não executados
Um include válido pode apontar para outras declarações; sem buscá-lo, a ausência de correspondência local é inconclusiva. relation_extensions é reconhecido, mas as rotas do Android 15 não são simuladas.
Estado do aparelho fora do JSON
autoVerify, assinatura instalada e cache do sistema não estão nesse arquivo. Examine o manifesto e consulte o aparelho com adb após instalar a versão relevante.

Dúvidas ao validar Android App Links

Por que o Link do App abre no navegador?

Mesmo com JSON correto, o servidor pode redirecionar, a assinatura Play pode ser outra ou a URL pode estar fora do manifesto. Validar Android App Links aqui reduz as causas locais; depois confira servidor e aparelho.

O que acontece em aparelhos com versões antigas do Android?

Antes do Android 15, dynamic_app_link_components é ignorado. Declare no manifesto os caminhos necessários para versões anteriores e teste nos aparelhos de destino.

Com que frequência assetlinks.json é atualizado no aparelho?

O intervalo depende do sistema e do cache; o arquivo local não informa um prazo fixo. Depois de publicar, force nova verificação com adb e consulte o estado do pacote instalado.

Posso combinar regras do manifesto e regras dinâmicas?

Sim, mas regras dinâmicas não podem ampliar o escopo definido pelo manifesto. Esta página identifica a extensão sem calcular o destino de cada URL.

Onde encontro a impressão digital SHA-256 para assetlinks.json?

Com Play App Signing, consulte o certificado da chave de assinatura do app no Play Console. Para builds locais, use keytool no armazenamento correto. Não é o SHA-256 do próprio assetlinks.json.

Alguma declaração parece errada?

Comece a validar Android App Links

Cole a lista planejada para validar Android App Links, compare o certificado de assinatura e depois siga as etapas de servidor e aparelho.

Os dados são processados apenas nesta aba.