使用入门

Sebastian Benz

若要集成自定义标签页，第一步是将 AndroidX 浏览器库添加到您的项目中。打开 app/build.gradle 文件，并将浏览器库添加到依赖项部分。

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

注意：如需查看一个可运行的示例，请参阅 GitHub 上的 Android 自定义标签页示例应用。

在自定义标签页中打开链接

安装 androidx.browser/browser 库后，您可以使用 CustomTabsIntent.Builder 创建 CustomTabsIntent，并通过调用 launchUrl() 并传递 Uri 来启动自定义标签页：

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

这会打开一个全屏自定义标签页 activity，如以下屏幕截图所示。

要点：如果用户的默认浏览器不支持自定义标签页，会怎么样？大多数 Android 浏览器都支持自定义标签页，但如果未安装任何支持自定义标签页的浏览器，CustomTabIntent 将改为打开用户的默认浏览器。这会起作用，因为 CustomTabsIntent 使用带有 Extras 键的 ACTION\_VIEW intent 自定义界面。

支持 Android App Links

默认情况下，自定义标签页支持 Android App Links。也就是说，如果已安装 YouTube 应用，使用 YouTube 视频网址启动 CustomTabsIntent 将打开 YouTube 应用，而不是浏览器。

不过，将 CustomTabsSession 传递给 CustomTabIntent 会强制在自定义标签页中打开链接，即使已安装相应的原生应用也是如此。如果您想保留在原生应用中打开网页链接的默认行为，则还需要按照有关如何检查链接是否可以由已安装的原生应用处理的指南操作。

后续：了解如何自定义自定义标签页的外观和风格。