Processar Android App Links

Os links diretos lidam com URIs de conteúdo. Os links da Web gerenciam 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 Android App Links para levar os usuários a um conteúdo específico de link diretamente no 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 usam 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 Links do app Android, é importante entender os diferentes tipos de links que você pode criar no app Android: links diretos, da Web e Links do app Android. A Figura 1 mostra a relação entre esses tipos de links, e as seções a seguir 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 seu 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, incluindo seu app, que podem processar o link direto fornecido. A Figura 2 mostra a caixa de diálogo depois que o usuário clica em um link do 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, um clique 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 do 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, será exibida uma caixa de diálogo de desambiguação semelhante à mostrada 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 (API de nível 23) 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 seja designado como o gerenciador padrão de um determinado tipo de link. Assim, quando o usuário clica em um Link do app Android, seu app é aberto imediatamente (se estiver instalado). A caixa de diálogo de desambiguação não é exibida.

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 Android App Links usam URLs HTTP vinculados a um domínio de site que pertence a você. Assim, nenhum outro app pode usar seus links. Um dos requisitos dos Links do app Android é que você confirme a propriedade do domínio usando um dos nossos métodos de associação de sites.
  • Experiência do usuário perfeita:como os Links do app Android 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 o site em vez do app, sem erros 404 nem erros.
  • Compatibilidade com Apps instantâneos Android:com os Instant Apps Android, os usuários podem executar seu app Android sem 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.
  • Envolvimento dos usuários a partir da Pesquisa Google:os usuários abrem conteúdo específico diretamente no app clicando em um URL do Google no navegador para dispositivos móveis, no app Pesquisa Google, na Pesquisa direta no Android ou usando o Google Assistente.

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

  1. Crie links diretos para conteúdo específico no app:no manifesto do app, crie filtros de intent para os URIs do site e configure o app para usar dados das intents e direcionar os usuários ao conteúdo certo no app. Saiba mais em Criar links diretos para conteúdo de app.
  2. Adicione verificação para seus links diretos:configure seu app para solicitar a verificação dos links de apps. Em seguida, publique um arquivo JSON do Digital Asset Links nos seus sites para verificar a propriedade pelo 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 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. Após o upload de um app, o painel (localizado em Crescer > Links diretos) exibe 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 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 mostra o status do link direto e uma maneira de corrigi-lo em caso de erro.

Consulte este guia para saber mais sobre o painel.