小米手机 Android 凭据服务设置 (android-credential-service-setup)
# 基于 ADB 切换 Android 凭据服务至 Google 与 Bitwarden
## 1. 核心作用与背景
在部分国产 Android 系统(如澎湃 OS / MIUI)中,系统设置界面通常对默认凭据管理器做了白名单限制,用户无法在图形设置界面中自由指定 Google 密码管理器或原生 Passkey(通行密钥)组件。
通过底层 ADB 指令直接向系统安全配置(`secure settings`)注册指定的凭据服务,可以强制绕过界面限制[cite: 1]:
`adb shell settings put secure credential_service "com.google.android.gms/.auth.api.credentials.credman.service.PasswordAndPasskeysService"`
---
## 2. 卸载小米自带凭据组件
小米系统的原厂凭据抓取与自动填充集成在系统组件 `com.miui.contentcatcher`(传送门/内容抓取服务)中。
可在终端执行免 Root 卸载命令(仅针对当前用户 0 移除):
`adb shell pm uninstall --user 0 com.miui.contentcatcher`
> **说明:**
> 该组件并非系统核心引导依赖(非 SystemUI 或安全中心),移除后手机仍可正常开机与日常使用,仅小米系统的“传送门”功能会同步失效。
---
## 3. 配置 Google 与 Bitwarden 双凭据共存
Android 14+ 凭据架构支持以冒号 `:` 并列多个凭据提供方。若希望以 Google Passkey 为主、Bitwarden 作为备选,执行以下命令:
`adb shell settings put secure credential_service "com.google.android.gms/.auth.api.credentials.credman.service.PasswordAndPasskeysService:com.x8bit.bitwarden/com.x8bit.bitwarden.Autofill.CredentialProviderService"`
### 验证写入结果
`adb shell settings get secure credential_service`
---
## 4. 关键注意事项
* **权限拦截错误:**
若执行命令时提示 `SecurityException: Permission denial, must have WRITE_SECURE_SETTINGS`,需进入手机 **系统设置 -> 更多设置 -> 开发者选项**,开启 **USB 调试(安全设置)**(需要插入 SIM 卡并登录小米账号进行倒计时确认)。
* **两层密码体系的区别:**
* **自动填充服务(Autofill Service):** 位于“设置 -> 语言与输入法 -> 自动填充服务”,属于传统排他通道,同一时间只能勾选一个服务(Google 或 Bitwarden)作为输入法表单默认填充源。
* **凭据管理器(Credential Manager):** 上述命令配置的底层接口,处理 WebAuthn 与 Passkeys,在应用请求认证时支持弹出系统级浮层供用户选择不同保存位置。