安卓端向Google Assistant推送动态快捷方式后应用未在其设置列表展示

排查解决步骤 #

• 首先确认数字资产链接（Digital Asset Links）配置正确。Google Assistant需要验证你对应用的所有权，未完成验证的应用不会出现在快捷方式列表中。需要在应用关联的站点根目录下的.well-known/assetlinks.json文件中，添加当前应用包名、签名对应的配置，测试阶段需要把debug签名和release签名的指纹都加入，不要只加线上release的签名。
• 检查Google Assistant当前使用的语言，需要和你快捷方式的标签、queryPatterns对应的字符串资源语言完全匹配，语言不匹配时Assistant不会检索到你的应用快捷方式。
• 你使用的是自定义action，Google Assistant对自定义action的快捷方式收录本身有一定延迟，尤其是未提交到Google Play审核的开发版本。可以先替换为Google官方提供的通用内置intent做测试，先确认整个收录链路是通的，再换回自定义action调试。
• 检查AndroidManifest.xml配置，确认在Application标签下已经正确添加了快捷方式元数据声明：

<meta-data
    android:name="android.app.shortcuts"
    android:resource="@xml/shortcuts" />

很多开发者会遗漏这一步，导致静态快捷方式无法被Assistant读取。

• 清除Google App缓存后重试：Assistant的快捷方式索引存储在Google App中，本地缓存未更新时会看不到新添加的快捷方式。操作路径：系统设置→应用管理→找到Google App→存储→清除缓存，重启手机后再进入Assistant快捷方式页面查看。
• 如果当前开发版本的包名和线上已发布版本一致，但使用的是debug签名，要确保assetlinks.json里同时添加了debug和release签名的SHA256指纹，否则Google会判定为非官方应用，不会收录对应的快捷方式。

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