如何复用加载同一URL的Chrome自定义标签页？

依赖库：androidx.browser:browser:1.5.0

问题分析 #

你的MainActivity设置了singleInstance模式，导致应用任务栈独立，加上原有代码缺少CustomTabs服务初始化步骤、Intent Flags设置不完整，使得每次点击按钮都会新建Chrome自定义标签页实例，无法复用已有的后台标签页。

解决方案 #

修正后的代码会确保CustomTabsSession有效初始化，同时通过正确的Intent Flags触发标签页复用逻辑：

1. 定义成员变量 #

private CustomTabsClient customTabsClient;
private CustomTabsSession customTabsSession;
private CustomTabsServiceConnection customTabsServiceConnection;
private String myURL = "你的目标URL"; // 替换为实际要打开的URL

2. 初始化CustomTabs服务与Session #

private void initCustomTabs() {
    if (customTabsSession == null) {
        customTabsServiceConnection = new CustomTabsServiceConnection() {
            @Override
            public void onCustomTabsServiceConnected(@NonNull ComponentName name, @NonNull CustomTabsClient client) {
                customTabsClient = client;
                // 先warmup初始化服务，这是创建有效Session的前提
                customTabsClient.warmup(0L).addOnSuccessListener(aVoid -> {
                    customTabsSession = customTabsClient.newSession(null);
                    launchCustomTab(myURL);
                });
            }

            @Override
            public void onServiceDisconnected(ComponentName name) {
                customTabsClient = null;
                customTabsSession = null;
            }
        };
        // 自动选择支持自定义标签页的最佳浏览器，避免硬编码Chrome
        String packageName = CustomTabsPackageHelper.getPackageNameToUse(this);
        if (packageName != null) {
            CustomTabsClient.bindCustomTabsService(this, packageName, customTabsServiceConnection);
        }
    } else {
        // 检查Session是否还能处理目标URL，失效则重新初始化
        if (customTabsSession.mayLaunchUrl(Uri.parse(myURL), null, null)) {
            launchCustomTab(myURL);
        } else {
            resetCustomTabsSession();
            initCustomTabs();
        }
    }
}

// 重置Session与服务连接
private void resetCustomTabsSession() {
    if (customTabsServiceConnection != null) {
        unbindService(customTabsServiceConnection);
    }
    customTabsClient = null;
    customTabsSession = null;
    customTabsServiceConnection = null;
}

3. 启动自定义标签页（复用逻辑核心） #

private void launchCustomTab(String url) {
    CustomTabsIntent.Builder builder = new CustomTabsIntent.Builder(customTabsSession);
    CustomTabsIntent customTabsIntent = builder.build();
    // 设置Flags：将已有标签页移至前台，且不新建实例
    customTabsIntent.intent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP | Intent.FLAG_ACTIVITY_REORDER_TO_FRONT);
    customTabsIntent.launchUrl(this, Uri.parse(url));
}

4. 清理资源（Activity销毁时） #

@Override
protected void onDestroy() {
    super.onDestroy();
    resetCustomTabsSession();
}

关键注意点 #

• warmup必须调用：CustomTabsClient绑定后需要通过warmup(0L)初始化服务，否则创建的Session无法参与标签页复用。
• Intent Flags组合：FLAG_ACTIVITY_REORDER_TO_FRONT会让系统把后台的Chrome标签页任务移到前台，FLAG_ACTIVITY_SINGLE_TOP确保不会在Chrome任务栈中新建标签页Activity。
• Session有效性检查：通过mayLaunchUrl判断Session是否还能处理目标URL，避免使用失效Session导致的复用失败。

内容的提问来源于stack exchange，提问作者Abdullah Alater