Processar Android App Links

Os links diretos lidam com URIs de conteúdo. Os links da Web cuidam da esquemas HTTP e HTTPS. Os Links do app Android processam a 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 app, ignorando a caixa de diálogo de seleção de apps, também conhecida como desambiguação caixa de diálogo. 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 ao conteúdo do seu site.

Antes de implementar os Links do app Android, é importante entender as diferentes tipos de links que você pode criar em seu aplicativo Android: links diretos, web e Links do app Android. A Figura 1 mostra a relação entre esses tipos de links. 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 intenção para direcionar os usuários à direita atividade no seu 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. Isso permite que o usuário selecione um dos vários aplicativos, incluindo seu aplicativo, que pode lidar com o link direto fornecido. A Figura 2 mostra a caixa de diálogo depois que o usuário clica nele. 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. Ativado Android 12 e versões mais recentes, cliques em um link da Web (que não seja 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 instalado no dispositivo do usuário também lida com o link da Web, mas os usuários podem diretamente no navegador. Em vez disso, ele verá uma caixa de diálogo de desambiguação semelhante a o 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 da Web. links que usam os esquemas HTTP e HTTPS e contêm o autoVerify . Esse atributo permite que o app se designe como o padrão manipulador de um determinado tipo de link. Então, quando o usuário clica em um Link do app Android, o app abre imediatamente se estiver instalado. A caixa de diálogo de desambiguação não aparecer.

Se o usuário não quiser que seu app seja o gerenciador padrão, ele pode modificar 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 que levam a um site que você possui, portanto nenhum outro app pode usar seus links. Um dos requisitos para apps Android Você precisa verificar a propriedade do seu domínio usando um dos nossos métodos de associação de sites.
  • Experiência do usuário perfeita: já que 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 tiverem o app instalado basta acessar seu site em vez do app: sem erros 404 e sem erros.
  • Compatibilidade com Apps instantâneos Android:com os Apps instantâneos Android, os usuários podem executar sua Android sem instalá-lo. Para que seu app Android seja compatível com o app instantâneo, configure Links do app Android e acesse g.co/InstantApps.
  • Engajar os 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, Pesquisa direta no Android ou com o Google Assistente.

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

  1. Crie links diretos para conteúdo específico no app: no manifesto do app, criar filtros de intent para os URIs do seu site e configurar o aplicativo para usar dados das intents. para direcionar os usuários ao conteúdo certo no seu app. Saiba mais em Criar links diretos para conteúdo de app.
  2. Adicionar verificação para links diretos:configure o app para solicitar verificação de links de apps. Em seguida, publique um arquivo JSON do Digital Asset Links nos seus sites para confirmar propriedade por Google Search Console. Saiba mais em Verificar links de app.

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

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 do aplicativo concluído no painel (localizada 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 mais informações sobre a mais avançado.