Google Assistant无法识别自定义Intent问题求助

核心排查与解决步骤 #

1. 自定义Intent命名与配置合规性 #

• 自定义Intent必须使用反向域名格式（例如com.yourdomain.actions.intent.GET_STATUS），避免custom.这类无归属的通用前缀，Google Assistant对非合规命名空间的Intent识别支持有限。
• 核对shortcuts.xml里的<capability>配置：android:name要严格匹配自定义Intent的完整名称，<query>的android:pattern必须覆盖测试用的查询语句，比如针对“how is home?”，pattern要包含how is home这类明确的匹配规则，不能有拼写或格式错误。

2. 快捷方式与组件关联验证 #

• 确认启动Activity的元数据配置无误：清单文件的启动Activity中，必须存在<meta-data android:name="android.app.shortcuts" android:resource="@xml/shortcuts" />，且路径指向正确的shortcuts.xml。
• 检查GetStatusWidgetProvider的接收器配置：接收器的<intent-filter>里必须包含<action android:name="custom.actions.intent.GET_STATUS" />，同时不要添加不必要的权限限制。

3. Google Assistant索引同步问题 #

• 手动触发应用能力同步：进入设备设置 > 应用 > 全部应用 > Google > 存储 > 清除缓存，重启设备后再测试查询。
• 确认安装版本：必须安装Google Play内部测试分发的版本，本地调试APK无法被Assistant索引能力。

4. 查询语句格式适配 #

• 调整查询语句匹配配置的pattern：如果shortcuts.xml里的查询模式是ask TEST APP about home status，就用对应语句测试；也可尝试“Hey Google, open TEST APP's home status shortcut”，验证快捷方式本身是否可被识别。
• 测试多条配置的查询语句，排除单条语句的匹配异常。

5. 回退Intent有效性检查 #

• 确认shortcuts.xml中<fallback-intent>指向的组件（Activity/服务）已在清单文件正确注册，且能正常响应，无禁用或权限限制。

额外验证命令 #

• 执行adb shell dumpsys shortcut查看设备已注册的快捷方式与能力，确认自定义Intent对应的shortcut是否存在、query patterns是否正确加载。

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