Processar Android App Links

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

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 Android App Links 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 app, também conhecida como caixa de diálogo de desambiguação. Como os Android App Links utilizam URLs HTTP e 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 Android App Links, é importante entender os diferentes tipos de links que você pode criar no app para Android: links diretos, links da Web e Android App Links. A Figura 1 mostra a relação entre esses tipos de links, e as seções a seguir descrevem cada tipo com 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 a seguir:

<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, incluindo o seu, que podem processar o link direto. A Figura 2 mostra a caixa de diálogo depois que o usuário clica em um link de mapa, perguntando se ele 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 Android App Link) sempre mostra o conteúdo em um navegador da Web. Em dispositivos com versões anteriores do Android, se o app ou outros apps instalados no dispositivo de um usuário também puderem processar o link da Web, os usuários talvez não acessem diretamente o navegador. Em vez disso, eles vão ver uma caixa de diálogo de desambiguação semelhante à que aparece na figura 2.

O snippet de código a seguir 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 designe como o gerenciador padrão de um determinado tipo de link. Assim, quando o usuário clica em um link de app Android, seu app é aberto imediatamente se estiver instalado. A caixa de diálogo de desambiguação não aparece.

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

O snippet de código a seguir mostra um exemplo de filtro de link de 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" />

    <!-- Do not include other schemes. -->
    <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 Android App Links 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 Android App Links é que você verifique a propriedade do seu domínio por meio de um dos nossos métodos de associação de sites.
  • Experiência do usuário perfeita:como os Android App Links usam um único URL HTTP para o mesmo conteúdo no site e no app, os usuários que não têm o app instalado acessam apenas o site, sem páginas 404 ou outros erros.
  • Compatibilidade com Instant Apps Android:com o Instant Apps Android, os usuários podem executar seu app para Android sem instalá-lo. Para que seu app para Android seja compatível com o Instant Apps, configure os Android App Links e acesse g.co/InstantApps.
  • Envolvimento dos 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 no navegador do dispositivo móvel, no app Pesquisa Google, na "Pesquisa direta" no Android ou por meio do Google Assistente.

As etapas gerais para a criação de Android App Links são:

  1. Crie links diretos para conteúdo específico no seu app:no manifesto do app, crie filtros de intent para os URIs do seu site e configure o app para usar dados dos intents e enviar os usuários ao conteúdo certo no app. Saiba mais em Criar links diretos para o conteúdo do aplicativo.
  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 Digital Asset Links nos seus sites para verificar a propriedade por meio do Google Search Console. Saiba mais em Verificar links de app.

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

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

Gerenciar e verificar os Links do app Android

É possível gerenciar e verificar links diretos no Play Console. Depois que um app é enviado, o painel (em "Crescimento" > "Links diretos") mostra uma visão geral dos links diretos e erros de configuração.

Figura 3. Painel de links diretos do Play Console

O painel oferece as seguintes seções:

  • Destaques da configuração geral de 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 mostra o status do link direto e uma maneira de corrigir os erros.

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