Como começar

Sebastian Benz

A primeira etapa para uma integração de guias personalizadas é adicionar a biblioteca de navegador do AndroidX ao seu projeto. Abra o arquivo app/build.gradle e adicione a biblioteca do navegador à seção de dependências.

dependencies {
   …
   implementation 'androidx.browser:browser:1.5.0'
}

Observação:confira o app de exemplo de guia personalizada do Android no GitHub (link em inglês) para conferir um exemplo prático.

Abrir um link em uma guia personalizada

Com a biblioteca androidx.browser/browser instalada, você pode usar o CustomTabsIntent.Builder para criar um CustomTabsIntent e iniciar a guia personalizada chamando launchUrl() e transmitindo um URI:

String url = "https://developers.android.com";
CustomTabsIntent intent = new CustomTabsIntent.Builder()
        .build();
intent.launchUrl(MainActivity.this, Uri.parse(url));

Isso vai abrir uma atividade em tela cheia da guia personalizada, como mostrado na captura de tela a seguir.

Importante:o que acontece se o navegador padrão do usuário não for compatível com guias personalizadas? As guias personalizadas são compatíveis com a maioria dos navegadores do Android, mas se nenhum navegador compatível estiver instalado, o CustomTabIntent abrirá o navegador padrão do usuário. Isso funciona, porque o CustomTabsIntent usa a intent ACTION\_VIEW com a chave Extras para personalizar a interface.

Compatibilidade com Links do app Android

Por padrão, as guias personalizadas são compatíveis com Links do app Android. Isso significa que, se o app YouTube estiver instalado, abrir um CustomTabsIntent com um URL de vídeo do YouTube abrirá o app YouTube em vez do navegador.

No entanto, transmitir um CustomTabsSession para um CustomTabIntent força a abertura do link em uma guia personalizada, mesmo que o app nativo correspondente esteja instalado. Para manter o comportamento padrão de abertura de links da Web em apps nativos, siga nosso guia sobre como verificar se um link pode ser processado por um app nativo instalado.

A seguir: saiba como personalizar a aparência da sua guia personalizada.