Gerador de apple-app-site-association e assetlinks.json
Preencha os identificadores do seu app e receba os dois arquivos, verificados e prontos para copiar ou baixar.
Como funciona
- Preencha a parte do iOS, a do Android ou as duas; cada campo é verificado na hora de gerar.
- Os arquivos são montados no seu navegador nos formatos atuais documentados pela Apple e pelo Google.
- Envie-os para /.well-known/ no domínio dos seus links e depois passe-os pelo validador.
O que você precisa da Apple
Seu Team ID: dez letras e números, mostrado em Membership details na sua conta Apple Developer. Seu bundle ID, como com.example.app, do Xcode ou do App Store Connect. O ID do app no arquivo é os dois unidos por um ponto.
Os caminhos decidem quais links abrem o app. “/*” pega todos os links do domínio; “/promo/*”, só os que estão em /promo. Comece uma linha com NOT para excluí-la — as exclusões precisam vir antes da regra da qual fazem exceção, porque o iOS usa a primeira correspondência.
O que você precisa do Google
O nome do pacote (o applicationId) e a impressão digital SHA-256 de cada certificado que assina uma build que as pessoas instalam. Com o Google Play App Signing, copie-a do Play Console em Integridade do app; para a sua própria keystore, keytool -list -v a mostra.
As impressões digitais são 32 pares de dígitos hexadecimais separados por dois-pontos. O gerador as aceita com ou sem dois-pontos, em maiúsculas ou minúsculas, e as escreve do jeito que o Android espera.
Como publicar os arquivos
Coloque o apple-app-site-association (sem extensão) e o assetlinks.json na pasta /.well-known/ do host exato que os seus links usam, servidos por HTTPS, sem redirecionamento e como application/json.
Depois declare o domínio no app: “applinks:” mais o host em Associated Domains no iOS, e um intent filter com android:autoVerify="true" para esse host no Android. Os links funcionam depois que os usuários instalam a build que contém isso.
Com um link do SetLinks você pode pular a hospedagem: informe os mesmos identificadores no link e o SetLinks publica os arquivos — para iPhone no setlinks.io ou no seu domínio próprio, para Android no seu domínio próprio.
Perguntas frequentes
O que é o arquivo apple-app-site-association?
Um arquivo JSON que diz ao iOS quais apps podem abrir quais links no seu domínio. Sem ele, os Universal Links abrem no Safari.
O que é o assetlinks.json?
O arquivo Digital Asset Links do Google: ele declara quais apps Android, identificados pelo nome do pacote e pelo certificado de assinatura, podem abrir links no seu domínio como App Links verificados.
O arquivo AASA precisa da extensão .json?
Não. Ele deve se chamar apple-app-site-association, sem extensão, e mesmo assim ser servido com o content type application/json.
Um arquivo pode listar vários apps?
Sim. Gere uma entrada por app e junte os arrays details (iOS) ou os arrays de declarações (Android) num só arquivo.
Meus identificadores são enviados para algum lugar?
Não. Os arquivos são gerados no seu navegador.
Mais ferramentas grátis
- Gerador de QR code para App Store e Google Play
- Gerador de links para App Store e Google Play
- Teste de redirecionamento de link inteligente
- Validador de Universal Links e App Links
Um link e um QR code para todas as lojas
O SetLinks leva cada visitante à loja dele e conta cada clique. Comece grátis.
Criar um link inteligente