Abrir links no seu app (deep linking)

Requer alterações no seu app

1. Passo 1

   Antes de começar

   Isto exige que você envie dois arquivos, o que você mesmo pode fazer se tiver os valores necessários, mas as alterações no app e as novas versões exigem um desenvolvedor. Você precisa de um domínio personalizado ativo — veja Configurar um domínio personalizado.
2. Passo 2

   Adicionar o arquivo de iOS

   Em Settings > Custom Domains, abra o domínio e o painel Open in app dele, e escolha Build it for me ao lado de iOS. Digite dois valores do seu app:
   • App ID Prefix — dez caracteres, em Membership em developer.apple.com (normalmente o seu Team ID)
   • Bundle ID — do Xcode, como com.example.app
   Revise o arquivo e salve-o. Se você já tem um arquivo apple-app-site-association, envie-o em vez disso.

   

3. Passo 3

   Adicionar o arquivo de Android

   O Google Play Console mostra o arquivo do seu app: na página App integrity do app, em App signing, copie o Digital Asset Links JSON. Salve-o como assetlinks.json e envie-o ao lado de Android no mesmo painel.

   

4. Passo 4

   Indicar o domínio no app de iOS

   No Xcode, abra Signing & Capabilities do seu target, adicione Associated Domains e adicione uma entrada para o seu domínio:

   applinks:get.example.com

   Depois, trate o link recebido no app — a URL chega como uma user activity — e mostre o conteúdo correspondente. A Apple descreve os dois em Supporting associated domains.
5. Passo 5

   Indicar o domínio no app de Android

   No AndroidManifest.xml, adicione um intent filter à activity que deve abrir os links:

   <intent-filter android:autoVerify="true">
     <action android:name="android.intent.action.VIEW" />
     <category android:name="android.intent.category.DEFAULT" />
     <category android:name="android.intent.category.BROWSABLE" />
     <data android:scheme="https" android:host="get.example.com" />
   </intent-filter>

   Depois, trate o link recebido nessa activity e mostre o conteúdo correspondente. O Google descreve os dois em Verify Android App Links.
6. Passo 6

   Escolher quais links abrem qual app

   Com a configuração acima, todo link do domínio abre o seu app. Para abrir só alguns links, ou para compartilhar o domínio entre vários apps, associe caminhos específicos a cada app:
   • iOS: o seu app indica só o domínio. O arquivo enviado define quais caminhos abrem qual app.
   • Android: o seu app indica o domínio e os caminhos. O arquivo enviado só lista quais apps podem usar o domínio.
   No iOS, escreva o seu próprio apple-app-site-association com os caminhos de cada app, ou com uma regra de exclusão para tirar um único link, e envie-o. Não é preciso atualizar o app. Novas instalações recebem a mudança em cerca de um dia, e os apps já instalados recebem nos dias seguintes.
   No Android, os caminhos ficam no intent filter de cada app, como android:pathPrefix="/webshop", então uma mudança exige uma atualização do app.
7. Passo 7

   Envie primeiro, publique depois

   Coloque os dois arquivos no lugar antes que as novas versões do app cheguem às lojas. O Android verifica o domínio uma vez, quando o app é instalado ou atualizado, e a Apple se lembra de um arquivo ausente por cerca de um dia — um app publicado antes que o seu arquivo esteja no ar não abrirá links para os seus primeiros usuários.
8. Passo 8

   Testar em um dispositivo

   Digitar o link na barra de endereço do navegador não abre apps, em nenhuma das plataformas. Em vez disso, instale a nova build e toque em um link para o seu domínio no Notas, no Mensagens ou em um email.
   Um toque que abre o app vai direto para o app, então não aparece nas estatísticas do seu Onelink.