Google Assistant语音指令仅打开Flutter应用，未触发shortcuts.xml中定义的App Action能力

我明白你现在遇到的困扰——明明配置了App Actions的所有前置条件，App Links、长按快捷方式都正常工作，但Google Assistant的语音指令就是不按预期触发对应的功能，只像普通启动一样打开应用主界面。我来帮你梳理几个可能的排查点和修复方案：

1. 先通过App Actions Test Tool验证配置有效性 #

Google Assistant需要时间索引应用的App Actions配置，尤其是内部测试版本的应用，直接用自然语音测试容易因为索引未完成或语义歧义导致失败。优先用**App Actions Test Tool (AATT)**来精准测试：

• 运行命令直接测试你的指令，能快速验证配置是否被正确识别：

  gactions test --package-name com.mycompany.myappname --command "Hey Google, open Cool Feature in MyAppName"
  

• 如果测试失败，AATT会返回具体的错误信息（比如参数映射错误、capability未识别等），这比自然语音测试更高效。
• 同时确保测试设备登录的Google账号是内部测试的授权账号，并且尝试重启Google Assistant或清除其缓存，强制同步配置。

2. 核对shortcuts.xml的参数映射与完整性 #

你的配置逻辑看起来没问题，但有几个细节需要确认：

• 检查res/values/strings.xml中cool_feature_value的定义是否完整：从你提供的片段看，最后一行有语法截断，必须确保字符串闭合且内容正确（比如完整的<string name="cool_feature_value">MyCoolFeature</string>），否则静态快捷方式的capability绑定会失效。
• 确认语音指令中的feature名称与参数值的映射：当你说“open Cool Feature in MyAppName”时，Google Assistant需要将自然语言的“Cool Feature”关联到你定义的MyCoolFeature参数值。如果没有配置同义词，Assistant可能无法正确映射，你可以在capability中添加possibleValues来明确关联：

  <capability android:name="actions.intent.OPEN_APP_FEATURE">
      <intent android:targetPackage="com.mycompany.myappname" android:targetClass=".MainActivity">
          <url-template android:value="https://myapp-links.example.com/play{?featureName}" />
          <parameter android:name="feature" android:key="featureName" android:required="false">
              <possible-values>
                  <value>MyCoolFeature</value>
                  <value name="Cool Feature">MyCoolFeature</value>
              </possible-values>
          </parameter>
      </intent>
  </capability>
  

3. 验证MainActivity接收的Intent类型 #

你的MainActivity配置了singleTop启动模式，这没问题，但需要确认当Assistant触发App Actions时，发送的是VIEW类型的Intent还是MAIN类型。可以在MainActivity中添加日志代码，查看实际接收的Intent：

// Kotlin版MainActivity示例
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    handleIntent(intent)
}

override fun onNewIntent(intent: Intent?) {
    super.onNewIntent(intent)
    setIntent(intent)
    handleIntent(intent)
}

private fun handleIntent(intent: Intent?) {
    intent?.let {
        Log.d("AppActionsDebug", "Action: ${it.action}, Data: ${it.data}")
    }
}

如果日志显示Assistant发送的是android.intent.action.MAIN，说明它没有识别到你的App Actions配置，需要回到索引和Play Console配置的排查；如果是android.intent.action.VIEW但Flutter端没有导航，那就是Flutter侧的deeplink处理逻辑需要调整。

4. 确认Play Console的配置同步状态 #

即使你上传了内部测试包，Google需要几个小时来同步应用的App Actions配置到Assistant的索引中：

• 登录Google Play Console，进入你的应用的App Actions页面，查看是否有配置错误或验证失败的提示。
• 尝试在设备上打开Google应用，搜索你的应用名称，查看是否显示App Actions的快捷方式推荐。如果没有，说明配置还未被索引，等待一段时间后再测试。

5. 设备端Assistant设置检查 #

• 确保设备上的Google Assistant是最新版本，更新Google应用到最新版。
• 进入Assistant设置（长按Home键→右上角头像→设置），在“应用”或“快捷方式”中确认你的应用的App Actions已启用。

内容来源于stack exchange