无法恢复com.google.android.gms.home模块，Matter设备添加失败求助

准备工作 #

• 设备开启USB调试，ADB工具正常连接设备
• 下载与当前Google Play Services版本（24.03.14）、设备架构匹配的com.google.android.gms.home模块安装包（通常为拆分APK）

操作步骤 #

1. 检查并清理现有模块 #

执行ADB命令确认模块状态：

adb shell pm list modules | grep home

• 无输出：模块未加载
• 有输出但功能异常：先卸载模块

adb shell pm uninstall -k --user 0 com.google.android.gms.home

2. 解除MIUI安装限制（仅针对Redmi/小米设备） #

MIUI默认限制系统模块安装，执行以下命令临时解除：

adb shell settings put global verifier_verify_adb_installs 0

3. 强制安装模块 #

将下载的拆分APK放到ADB目录下，执行批量安装命令：

adb install-multiple [模块APK文件名1] [模块APK文件名2] ...

注意：必须确保所有拆分APK文件都包含在命令中，否则安装失败

4. 验证恢复效果 #

1. 重启设备：

adb reboot

2. 再次检查模块状态：

adb shell pm list modules | grep home

3. 打开Google Home或Matter Sample App测试设备添加功能，同时查看ADB日志确认CommissioningClient.API不可用错误是否消失

补充说明 #

• 模块版本必须与当前Google Play Services版本严格对应，不匹配会导致GMS功能异常
• 若找不到对应版本的模块安装包，可尝试切换Google Play Services至更早的稳定Beta通道，待模块推送完成后再切回稳定版
• 清除Google Play Services全部数据（设置>应用>Google Play Services>存储>清除数据）后重新安装模块，可能解决部分兼容性问题

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