Android CustomTabs：bindCustomTabsService未触发onCustomTabsServiceConnected

以下是几个常见问题点和解决办法：

• 避免硬编码浏览器包名
  直接指定com.android.chrome会导致部分设备（比如默认浏览器不是Chrome、或Chrome版本过低不支持CustomTabs）无法正常绑定服务。应该使用CustomTabsPackageHelper.getPackageNameToUse(this)自动获取支持CustomTabs的浏览器包名，保证兼容性。

• 调整服务绑定的生命周期时机
  在onCreate中绑定服务可能因为Activity未完全初始化而失败，建议将绑定逻辑移到onStart或onResume方法中。同时必须在onDestroy中调用unbindService，避免内存泄漏并保证服务绑定生命周期正确。

• 添加错误回调排查问题
  默认的CustomTabsServiceConnection仅实现了两个基础方法，建议补充onBindingDied和onNullBinding方法并打印日志，通过这些回调可以明确服务绑定失败的具体原因。

• 验证设备是否存在支持CustomTabs的浏览器
  如果设备上没有任何支持CustomTabs的浏览器（比如仅安装了不支持的老旧浏览器），绑定自然会失败。可以通过CustomTabsPackageHelper.getPackageNameToUse(this)的返回值是否为null来判断。

修改后的示例代码 #

private var mClient: CustomTabsClient? = null
private var mServiceConnection: CustomTabsServiceConnection? = null

override fun onStart() {
    super.onStart()
    val packageName = CustomTabsPackageHelper.getPackageNameToUse(this)
    packageName?.let {
        mServiceConnection = object : CustomTabsServiceConnection() {
            override fun onServiceDisconnected(name: ComponentName?) {
                mClient = null
            }

            override fun onCustomTabsServiceConnected(name: ComponentName, client: CustomTabsClient) {
                Log.d("CustomTabs", "Client connected")
                mClient = client
                client.warmup(0L)
            }

            override fun onBindingDied(name: ComponentName?) {
                Log.e("CustomTabs", "绑定失败：$name")
            }

            override fun onNullBinding(name: ComponentName?) {
                Log.e("CustomTabs", "空绑定：$name")
            }
        }
        CustomTabsClient.bindCustomTabsService(this, it, mServiceConnection!!)
    } ?: run {
        Log.e("CustomTabs", "未找到支持CustomTabs的浏览器")
    }
}

override fun onDestroy() {
    super.onDestroy()
    mServiceConnection?.let { unbindService(it) }
}

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