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, os usuários iniciam o app clicando em um URL. Assim, todos os apps instantâneos precisam estar acessíveis por meio de um URL declarado usando os links de apps para Android. Esta página explica como usar links de app para 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ê confirma que o app é o verdadeiro proprietário desses URLs. Assim, você converteu seus links diretos em links de apps para Android, o que garante que seu app seja aberto instantaneamente quando o usuário clicar em um URL desse tipo. Para criar links de apps, leia Verificar links de apps para 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 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 para Criar links diretos para conteúdo de app e Verificar links de apps para Android, 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>
        

    Não é preciso incluir o parâmetro 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 de 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.
  • É preciso definir autoVerify="true" em pelo menos um filtro de intent no app 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 compatível 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 o 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.