Como começar

Sebastian Benz

A primeira etapa para uma integração de guias personalizadas é adicionar a Biblioteca do navegador 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 da guia personalizada do Android no GitHub 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 abrirá uma atividade da Guia Personalizada em tela cheia, como mostra a 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 Android. No entanto, se nenhum navegador compatível com guias personalizadas estiver instalado, o CustomTabIntent abrirá o navegador padrão do usuário. Isso funciona porque o CustomTabsIntent usa a intent ACTION\_VIEW com a tecla Extras para personalizar a interface.

Compatibilidade com Links do app Android

Por padrão, as guias personalizadas são compatíveis com os Links do app Android. Isso significa que, se o app YouTube estiver instalado, iniciar uma 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. Se você quiser manter o comportamento padrão de abertura de links da Web em aplicativos nativos, siga também nosso guia sobre como verificar se um link pode ser tratado por um aplicativo nativo instalado.

A seguir: aprenda a personalizar a aparência da guia personalizada.