Criar links para apps instantâneos

Um Instant App Android é uma versão pequena do seu app executada sem instalação. Em vez de instalar um APK, basta que o usuário clique em um URL para abrir seu app. Dessa forma, todos os apps instantâneos precisam estar acessíveis por meio de um URL declarado usando os Android App Links. Esta página explica como usar Android App Links 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 permitindo que o usuário acesse diretamente uma tela específica no app usando 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ê confirma que o app é o verdadeiro proprietário desses URLs. Assim, você converteu seus links diretos em Android App Links, garantindo que seu app seja aberto instantaneamente quando o usuário clica em um URL desse tipo. Para criar links de app, consulte Verificar Android App Links.

Sendo assim, os Android App Links 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 ver uma descrição mais detalhada, leia sobre 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 seu app não tiver sido instalado (e nenhum outro app processar esse intent de URL), o URL será aberto em um navegador da Web. Assim, a criação de um app instantâneo resolve essa questão, uma vez que ele permite que os usuários abram seu app clicando em um URL, mesmo que não tenham o app instalado.

Quando o usuário final pesquisa seu app no Google, a Pesquisa Google exibe um URL com o selo "Instantâneo".

Se você já leu os guias Criar links diretos para conteúdo de app e Verificar Android App Links, já fez a maior parte do trabalho necessário para fazer com que links funcionem com seu app instantâneo. Existem apenas algumas regras extras ao usar links 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. Por 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>
        

    Observe que 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, este 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 do seu app instantâneo devem 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 deve sempre abrir o app instalado, não o instantâneo.
  • É necessário 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.
  • Você precisa publicar um assetlinks.json para cada domínio e subdomínio compatíveis com os 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 seu robots.txt permita o rastreamento de /.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.