Premiers pas

La première étape de l'intégration des onglets personnalisés consiste à ajouter la bibliothèque du navigateur AndroidX à votre projet. Ouvrez le fichier app/build.gradle et ajoutez la bibliothèque du navigateur à la section des dépendances.

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

Une fois la bibliothèque androidx.browser/browser installée, vous pouvez utiliser CustomTabsIntent.Builder pour créer un CustomTabsIntent et lancer l'onglet personnalisé en appelant launchUrl() et en transmettant un Uri:

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

Une activité d'onglet personnalisé s'affiche en plein écran, comme illustré dans la capture d'écran suivante.

Onglets personnalisés par défaut.

Par défaut, les onglets personnalisés sont compatibles avec Android App Links. Cela signifie que si l'application YouTube est installée, lorsque vous lancez un CustomTabsIntent avec l'URL d'une vidéo YouTube, l'application YouTube s'ouvre au lieu du navigateur.

Toutefois, transmettre un CustomTabsSession à un CustomTabIntent force l'ouverture du lien dans un onglet personnalisé, même si l'application native correspondante est installée. Si vous souhaitez conserver le comportement par défaut d'ouverture des liens Web dans les applications natives, vous devez également suivre notre guide pour vérifier si un lien peut être géré par une application native installée.

Dans la section suivante, découvrez comment personnaliser l'apparence de votre onglet personnalisé.