Android TV使用CredentialManager实现Google登录遇AccountTypePickerActivity缺失问题

问题分析 #

切换到Credential Manager API后，Android TV端点击「添加其他账号」时触发ActivityNotFoundException，找不到com.google.android.gms.common.account.AccountTypePickerActivity，但手机/平板设备运行正常，具体原因及解决方案如下：

1. 为何错误仅在Android TV上出现？ #

Android TV的交互框架与移动设备差异极大，AccountTypePickerActivity是为触摸操作优化的弹窗式账号选择组件，TV设备的GMS并未预装该组件，因此调用时会触发找不到Activity的异常。

2. Android TV版GMS是否移除了该Activity？ #

是的。Android TV的账号管理逻辑依赖系统设置入口完成，而非移动设备的弹窗选择器，因此GMS for TV直接移除了这个仅适用于触摸场景的Activity。

3. 兼容Credential Manager API的解决方法 #

针对TV设备做特殊处理：通过设备类型判断或异常捕获，引导用户通过系统设置添加Google账号，同时保留移动设备原有逻辑。

修改后的代码实现：

private fun getGoogleCredential(activity: FragmentActivity) {
    val signInWithGoogleOption = GetSignInWithGoogleOption
        .Builder(GOOGLE_API_CLIENT_ID)
        .build()

    val request = GetCredentialRequest.Builder()
        .addCredentialOption(signInWithGoogleOption)
        .build()

    activity.lifecycleScope.launch {
        try {
            val result = client.getCredential(request, activity)
            handleGoogleSignIn(result)
        } catch (e: Exception) {
            when {
                e is GetCredentialCancellationException -> return@launch
                isAndroidTv(activity) && e.cause is ActivityNotFoundException -> {
                    // TV设备引导至系统设置添加账号
                    showTvAccountSetupDialog(activity)
                }
                else -> e.printStackTrace()
            }
        }
    }
}

// 判断是否为Android TV设备
private fun isAndroidTv(context: Context): Boolean {
    val uiModeManager = context.getSystemService(Context.UI_MODE_SERVICE) as UiModeManager
    return uiModeManager.currentModeType == Configuration.UI_MODE_TYPE_TELEVISION
}

// 显示TV账号设置引导弹窗
private fun showTvAccountSetupDialog(activity: FragmentActivity) {
    AlertDialog.Builder(activity)
        .setTitle("添加Google账号")
        .setMessage("请前往系统设置 > 账号 页面添加Google账号后重试")
        .setPositiveButton("打开设置") { _, _ ->
            val intent = Intent(Settings.ACTION_ADD_ACCOUNT).apply {
                putExtra(Settings.EXTRA_ACCOUNT_TYPES, arrayOf("com.google"))
            }
            activity.startActivity(intent)
        }
        .setNegativeButton("取消", null)
        .show()
}

关键说明 #

• 通过UiModeManager准确识别TV设备，避免跨设备误判
• 捕获底层的ActivityNotFoundException，针对TV场景引导用户走系统原生账号添加流程
• 保留移动设备原有逻辑，不影响手机/平板的正常使用

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