无需发布至Google Play如何让Google Assistant识别应用与动态快捷方式

debug包无法被「Open [应用名]」指令识别解决步骤 #

• 确保AndroidManifest.xml中Application节点、主入口Activity节点的android:label属性值，和你要唤起的应用名称完全一致，不要包含特殊符号
• 安装Android Studio的App Actions Test Tool（AATT）插件，保证Android Studio登录的Google账号，和测试设备上Google Assistant绑定的Google账号为同一个
• 打开AATT面板，选择你的测试设备，工具会自动读取本地debug签名的SHA-256指纹，点击「Upload draft」将应用信息同步到当前账号的测试白名单中
• 清除测试设备上Google App的本地缓存，等待10-15分钟后即可测试语音唤起

动态快捷方式无法被识别解决步骤 #

• 首先在res/xml目录下创建shortcuts.xml，在文件中预先声明所有快捷方式对应的<capability>节点，每个节点的android:name属性要和你后续创建动态快捷方式时绑定的能力名完全匹配
• 创建动态快捷方式时，必须完成以下必要配置：
  • 调用setId()传入唯一的快捷方式ID
  • 调用setShortLabel()、setLongLabel()设置Assistant可识别的名称标签
  • 调用addCapabilityBinding()绑定shortcuts.xml中预定义的对应能力
  • 调用setCategories()传入"android.intent.category.LAUNCHER"分类
• 通过AATT上传你的shortcuts.xml配置到Google账号测试环境，同步完成后动态快捷方式即可被Assistant识别

额外适配说明 #

如果你是企业内部使用的私有应用，可以通过Google Workspace管理后台将应用添加到企业内部应用列表，同企业域下的所有账号无需单独配置白名单，即可正常使用Assistant唤起和快捷方式能力，不需要将应用上架到Google Play公开商店。

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