原生/Compose中触发Google密码管理器保存密码供Autofill使用

Android 8.0（API 26）及以上版本的系统自动填充框架原生支持主动触发凭证保存逻辑，不需要接入额外第三方SDK，在登录/注册成功回调中调用对应API，系统就会自动唤起当前启用的自动填充服务（包括Google Password Manager）的保存弹窗，保存后的凭证后续可直接被自动填充服务调用。

原生XML视图场景实现 #

1. 先确认输入框配置正确（你已完成autofillHints配置，可再核对取值）：
   • 邮箱输入框配置android:autofillHints="emailAddress"，或在代码中设置常量View.AUTOFILL_HINT_EMAIL_ADDRESS
   • 密码输入框配置android:autofillHints="password"，或在代码中设置常量View.AUTOFILL_HINT_PASSWORD
2. 在onLoginSuccess()回调中加入以下代码，注意调用时机要在输入框控件被销毁之前：

override fun onLoginSuccess() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val autofillManager = requireContext().getSystemService(AutofillManager::class.java)
        // 传入当前登录表单所在页面的根View，系统会自动遍历View树匹配对应hint的输入框内容
        autofillManager?.commit(binding.root)
    }
    // 原有登录成功后的业务逻辑（跳转、数据加载等）写在后面，不要提前销毁Fragment/Activity或清空输入框
}

注意：如果登录成功后立刻执行页面销毁、输入框清空操作，会导致系统无法采集到有效凭证，建议在commit调用后延迟100-200ms再执行页面移除、输入框重置类操作。

Jetpack Compose场景实现 #

Compose不需要手动获取系统服务，通过框架自带的Autofill API即可实现：

1. 为邮箱、密码输入框配置正确的自动填充类型：

// 邮箱输入框
OutlinedTextField(
    value = email,
    onValueChange = { email = it },
    label = { Text("邮箱") },
    modifier = Modifier.semantics {
        autofillType = AutofillType.EmailAddress
    }
)

// 密码输入框
OutlinedTextField(
    value = password,
    onValueChange = { password = it },
    label = { Text("密码") },
    visualTransformation = PasswordVisualTransformation(),
    modifier = Modifier.semantics {
        autofillType = AutofillType.Password
    }
)

2. 在登录成功逻辑中触发提交：

@Composable
fun LoginPage() {
    val autofillManager = LocalAutofillManager.current
    // 其余状态、业务逻辑省略

    fun handleLoginSuccess() {
        // 通知自动填充服务采集表单内容
        autofillManager?.commit()
        // 原有登录成功跳转、业务逻辑
    }
}

常见不触发弹窗的排查点 #

• 测试时确保当前系统默认自动填充服务为Google Password Manager，且已开启「保存密码提示」开关
• 不要在调用commit方法前手动清空邮箱、密码输入框的内容，否则系统无法采集到有效凭证
• 若测试用的账号密码组合已经被Google Password Manager保存过，系统不会重复弹出保存提示，可使用全新的测试账号验证
• 若登录表单承载于Dialog、PopupWindow等悬浮容器中，commit时传入的根View需要是悬浮容器的顶层View，否则系统遍历View树时无法匹配到对应输入框

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