Criar links para apps instantâneos

Um Instant App Android é uma versão pequena do seu app que é executada sem instalação. Em vez de instalar um APK, basta que o usuário clique em um URL para abrir o app. Dessa forma, todos os apps instantâneos precisam estar acessíveis por meio de um URL declarado usando Links do app Android. Esta página explica como usar os Links do app Android para seus Instant Apps Android.

Antes de começar, leia abaixo um resumo do que você já deve compreender sobre links de app.

  • Quando você cria um filtro de intent para atividades no seu app que permitem ao usuário acessar diretamente uma tela específica com um link de URL, isso é conhecido como "link direto". No entanto, outros apps podem declarar um filtro de intent de URL semelhante, e o sistema perguntará ao usuário qual app abrir. Para criar esses links diretos, leia Criar links diretos para conteúdo de app.
  • Ao publicar um arquivo assetlinks.json no site que corresponde aos links diretos HTTP do seu app, você verifica se o app é o verdadeiro proprietário desses URLs. Assim, você converteu seus links diretos em Links do app Android, que garantem que seu app seja aberto instantaneamente quando o usuário clicar em um URL. Para criar links de apps, leia Verificar Links do app Android.

Sendo assim, os links de apps para Android são apenas links diretos HTTP de que seu site tem a propriedade confirmada, para que o usuário não precise escolher qual app abrir. Para uma descrição mais específica, consulte as diferenças entre links diretos e links de app.

Nos dois casos, no entanto, o usuário precisa ter seu app instalado. Se o usuário clicar em um dos links do seu site e não tiver o app instalado (e nenhum outro app processar essa intent de URL), o URL será aberto em um navegador da Web. Portanto, a criação de um app instantâneo resolve essa questão: ele permite que os usuários abram seu app basta clicar em um URL, mesmo que ele não esteja instalado.

Quando os usuários finais pesquisam seu app no Google, a Pesquisa Google exibe um URL com o selo "Instantâneo".

Se você já seguiu os guias Criar links diretos para conteúdo de app e Verificar Links do app Android, já fez a maior parte do trabalho necessário para que os links funcionem com seu app instantâneo. Há apenas algumas regras extras ao usar links de app para apps instantâneos:

  • Todos os filtros de intent usados como links no seu app instantâneo precisam ser compatíveis com HTTP e HTTPS. Exemplo:

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

    Não é preciso incluir o host no segundo elemento <data> porque, dentro de cada elemento <intent-filter>, todas as combinações de cada atributo <data> são consideradas válidas. Assim, esse filtro de intent resolve https://www.example.com.

  • Somente um app instantâneo pode ser declarado para cada domínio de site. Isso não é válido para a criação de links para seu app instalável, que permite associar um site a vários apps.

  • Todos os filtros de intent de URL HTTP no app instantâneo precisam ser incluídos no app instalável. Isso é importante porque, depois que o usuário instala seu app completo, a ação de tocar em um URL tem sempre que abrir o app instalado, não o instantâneo.
  • Você precisa definir autoVerify="true" em pelo menos um filtro de intent nos apps instantâneo e instalável. Veja como ativar a verificação automática.
  • É necessário publicar um assetlinks.json para cada domínio e subdomínio com suporte aos links do seu app usando o protocolo HTTPS. Veja como oferecer compatibilidade com a vinculação de apps para vários hosts.
  • O arquivo assetlinks.json precisa ser JSON válido, exibido sem redirecionamentos e acessível a bots. É necessário que o robots.txt permita o rastreamento /.well-known/assetlinks.json.
  • Não é recomendado usar caracteres curingas no atributo de host do filtro de intent. Veja como oferecer compatibilidade com a vinculação de apps para vários subdomínios.
  • Os URLs de host/esquema personalizados devem ser declarados com filtros de intent separados.
  • Verifique se os URLs dos links de app são os principais resultados da pesquisa para seus termos-chave.