Processar Android App Links

Os links diretos processam URIs de conteúdo. Os links da Web processam os esquemas HTTP e HTTPS. Os Links do app Android processam o atributo autoVerify.
Figura 1. Recursos de links diretos, da Web e Links do app Android.

Os usuários que clicam em links em dispositivos só querem uma coisa: ver o conteúdo do que acessaram. Como desenvolvedor, você pode configurar Links do app Android para levar os usuários ao conteúdo específico de um link diretamente no seu app, ignorando a caixa de diálogo de seleção de apps, também conhecida como caixa de diálogo de desambiguação. Como os Links do app Android aproveitam os URLs HTTP e a associação a um site, os usuários que não têm o app instalado vão diretamente para o conteúdo do site.

Antes de implementar os Links do app Android, é importante entender os diferentes tipos de links que você pode criar no seu app Android: links diretos, da Web e Links do app Android. A Figura 1 mostra a relação entre esses tipos de links. As seções abaixo descrevem cada tipo de link em mais detalhes.

Links diretos são URIs de qualquer esquema que levam os usuários diretamente a uma parte específica do seu app. Para criar links diretos, adicione filtros de intent para direcionar os usuários à atividade correta no app, conforme mostrado no snippet de código abaixo:

<activity
    android:name=".MyMapActivity"
    android:exported="true"
    ...>
    <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="geo" />
    </intent-filter>
</activity>

Quando o usuário clica em um link direto, uma caixa de diálogo de desambiguação pode aparecer. Essa caixa de diálogo permite que o usuário selecione um dos vários apps que podem processar o link direto fornecido, incluindo seu app. A Figura 2 mostra a caixa de diálogo depois que o usuário clica em um link de mapa, perguntando se quer abrir o link no Maps ou no Chrome.

Figura 2. Caixa de diálogo de desambiguação.

Links da Web são links diretos que usam os esquemas HTTP e HTTPS. No Android 12 e versões mais recentes, clicar em um link da Web (que não seja um Link do app Android) sempre mostra o conteúdo em um navegador da Web. Em dispositivos com versões anteriores do Android, se o seu app ou outros apps instalados no dispositivo de um usuário também puderem processar o link da Web, os usuários poderão não ir diretamente para o navegador. Em vez disso, ele vai encontrar uma caixa de diálogo de desambiguação semelhante à que aparece na Figura 2.

O snippet de código abaixo mostra um exemplo de filtro de link da Web:

<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" />
    <data android:host="myownpersonaldomain.com" />
</intent-filter>

Os Links do app Android, disponíveis no Android 6.0 (nível 23 da API) e versões mais recentes, são links da Web que usam os esquemas HTTP e HTTPS e contêm o atributo autoVerify. Esse atributo permite que o app se autodesigne como o gerenciador padrão de determinado tipo de link. Assim, quando o usuário clicar em um Link do app Android, seu app será aberto imediatamente (se estiver instalado). A caixa de diálogo de desambiguação não será mostrada.

Se o usuário não quiser que seu app seja o gerenciador padrão, ele pode substituir esse comportamento nas configurações do app.

O snippet de código a seguir mostra um exemplo de filtro de Link do app Android:

<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="http" />
    <data android:scheme="https" />

    <data android:host="myownpersonaldomain.com" />
</intent-filter>

Os Android App Links oferecem os seguintes benefícios:

  • Seguro e específico:os Links do app Android usam URLs HTTP vinculados a um domínio de site que você possui. Assim, nenhum outro app pode usar seus links. Um dos requisitos dos Links do app Android é que você verifique a propriedade do domínio usando um dos nossos métodos de associação de sites.
  • Experiência do usuário integrada:como os Links do app Android usam um único URL HTTP para o mesmo conteúdo no seu site e app, os usuários que não têm o app instalado simplesmente acessam seu site em vez do app, sem erros 404 nem erros.
  • Suporte a Apps instantâneos Android:com eles, os usuários podem executar seu app Android sem precisar instalá-lo. Para que seu app Android seja compatível com o Instant Apps, configure os Links do app Android e acesse g.co/InstantApps.
  • Engajar usuários a partir da Pesquisa Google:os usuários abrem conteúdo específico diretamente no seu app clicando em um URL do Google em um navegador para dispositivos móveis, no app Pesquisa Google, na Pesquisa direta no Android ou pelo Google Assistente.

As etapas gerais para criar Links do app Android são as seguintes:

  1. Crie links diretos para conteúdo específico no app:no manifesto do app, crie filtros de intent para os URIs do seu site e configure o app para usar dados dos intents a fim de enviar os usuários ao conteúdo certo no app. Saiba mais em Criar links diretos para conteúdo do app.
  2. Adicione verificação para seus links diretos:configure seu app para solicitar a verificação dos links de app. Em seguida, publique um arquivo JSON do Digital Asset Links nos seus sites para verificar a propriedade com o Google Search Console. Saiba mais em Verificar links de app.

Como alternativa à documentação vinculada acima, o Android App Links Assistant é uma ferramenta do Android Studio que orienta você em cada uma das etapas necessárias para criar Android App Links.

Para mais informações, consulte os seguintes recursos:

Gerenciar e verificar Links do app Android

É possível gerenciar e verificar os links diretos no Play Console. Depois do upload de um app, o painel (localizado em Crescimento > Links diretos) exibe uma visão geral dos links diretos e erros de configuração.

Figura 3. Links diretos para o painel do Play Console

O painel oferece as seguintes seções:

  • Destaques da configuração geral dos links diretos
  • Todos os domínios declarados no arquivo de manifesto
  • Links da Web agrupados por caminho
  • Links com esquemas personalizados
Cada uma dessas seções exibe o status do link direto e uma maneira de corrigi-los em caso de erro.

Consulte este guia para mais informações sobre o painel.