Gerador de apple-app-site-association e assetlinks.json

Crie os dois arquivos que fazem os links do seu site abrirem o seu app: apple-app-site-association para Universal Links no iOS e assetlinks.json para App Links no Android. Ou cole arquivos existentes para verificá-los.

Atualizado em

iOS — Universal Links

Android — App Links

Encontre com keytool -list -v -keystore release.jks, ou no Play Console → Configuração → Assinatura do app.

      Edite qualquer arquivo diretamente para validar um existente. Os problemas aparecem listados abaixo dele.

      Seus dados nunca saem do seu computador. Todo o processamento acontece localmente no navegador.

      Como usar: Gerador de Deep Links

      1. Insira o seu Team ID da Apple, os bundle IDs e os caminhos de URL que devem abrir o app.
      2. Insira o nome do pacote Android e o fingerprint SHA-256 do certificado de assinatura.
      3. Baixe os dois arquivos e envie-os para https://seudominio/.well-known/. Ou cole arquivos existentes para validá-los.

      Onde hospedar os arquivos

      Os dois arquivos ficam na pasta /.well-known/ de cada domínio que deve abrir o seu app: https://exemplo.com/.well-known/apple-app-site-association (sem extensão) e https://exemplo.com/.well-known/assetlinks.json. Eles precisam ser servidos via HTTPS, sem redirecionamentos e com o tipo de conteúdo application/json. A Apple busca o arquivo AASA pela sua CDN quando o app está instalado, então as mudanças podem levar um tempo para chegar aos dispositivos.

      Correspondência de caminhos no iOS

      O formato moderno components compara caminhos com * (qualquer sequência de caracteres) e ? (um caractere). As regras são verificadas em ordem e a primeira que bater vence, então coloque as exclusões ("exclude": true, escritas como !/caminho acima) antes das regras mais amplas. Seu app também precisa do direito Associated Domains applinks:exemplo.com.

      Fingerprints no Android

      O assetlinks.json precisa listar o fingerprint SHA-256 do certificado que assina o app que os usuários instalam. Com o Play App Signing, essa é a chave de assinatura do app do Google no Play Console, e não a sua chave de upload. Esse é um motivo comum para os App Links não serem verificados. Adicione as duas se você testa builds de debug e de release. O intent filter no seu manifesto precisa de android:autoVerify="true".

      Também pesquisado como: gerador apple-app-site-association, gerador assetlinks.json, universal links ios, android app links, validador aasa, configurar deep links, digital asset links.

      Ferramentas que combinam com: Gerador de Deep Links

      • Gerador de ícones de aplicativos — Basta arrastar uma imagem quadrada e você terá todos os tamanhos de ícone que seu app precisa — um AppIcon.appiconset pronto para o Xcode, pastas de mipmaps do Android com ícones adaptáveis, o ícone da Play Store e ícones para a web/PWA — tudo em um único arquivo ZIP.
      • Gerador de security.txt — Preencha alguns campos para gerar um /.well-known/security.txt compatível com o padrão, que indica aos pesquisadores como reportar problemas de segurança para você.
      • Gerador de Robots.txt — Monte um robots.txt correto em segundos: escolha uma predefinição, adicione regras por user-agent, bloqueie os crawlers de treinamento de IA e liste seus sitemaps.
      • Verificador de Cabeçalhos HTTP — Busque qualquer URL e veja exatamente o que o servidor devolve: status code, cadeia de redirecionamentos e todos os cabeçalhos de resposta, com explicação em linguagem simples dos que importam para SEO, cache e segurança.

      Perguntas frequentes

      Por que meus Universal Links não abrem o app?
      Verifique se o arquivo AASA está disponível em /.well-known/ via HTTPS, sem redirecionamentos, se o appID está no formato TEAMID.bundleid, se o direito Associated Domains lista o domínio e se você tocou em um link em vez de digitar a URL. URLs digitadas abrem no Safari por design.
      Qual fingerprint SHA-256 devo usar no Android?
      O do certificado que assina o app instalado. Com o Play App Signing, copie o SHA-256 do certificado de chave de assinatura do app em Play Console → Configuração → Assinatura do app.
      O arquivo AASA precisa de extensão .json?
      Não. Ele deve se chamar exatamente apple-app-site-association, sem extensão, mas ser servido com o tipo de conteúdo application/json.
      Posso instalar o Gerador de Deep Links como um aplicativo da web e usá-lo offline?
      Sim. O Gerador de Deep Links é um aplicativo da web instalável (PWA) — instalado a partir do seu navegador, não baixado de uma loja de aplicativos. Clique em “Instalar aplicativo” na parte superior desta página no Chrome ou no Edge (Windows, macOS, Linux, ChromeOS) ou, no Android, use “Compartilhar” → “Adicionar à tela inicial” no iPhone e no iPad, ou “Arquivo” → “Adicionar ao Dock” no Safari 17+ em um Mac. Em seguida, ela se abre em uma janela própria com seu próprio ícone e, como é executada inteiramente no seu navegador, continua funcionando offline. O Firefox no desktop não permite a instalação de aplicativos da web. Como funciona a instalação.

      Ferramentas relacionadas