开始使用

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 结合使用 ACTION\_VIEW intent 和 Extras 键来自定义界面。

支持 Android App Links

默认情况下，自定义标签页支持 Android App Links。这意味着，如果安装了 YouTube 应用，启动带有 YouTube 视频网址的 CustomTabsIntent 将打开 YouTube 应用，而不是浏览器。

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

接下来：了解如何自定义自定义标签的外观和风格。