Siri自定义意图在iOS17.3.1设备上无法响应问题求助

已完成的Siri自定义意图配置 #

• Targets的Signing & Capabilities中已添加Siri权限
• 主应用info.plist中已配置NSUserActivityTypes指定自定义意图
• 项目授权文件中已声明Siri权限
• 意图扩展的info.plist中已通过NSExtensionPrincipalClass指定对应的意图处理类

测试验证情况 #

1. 应用已成功请求并获取Siri权限
2. 实现「添加到Siri」按钮，已成功添加快捷方式
3. 手动启动快捷方式可正常执行所有操作
4. 模拟器中启动应用后，可通过语音调用Siri执行所有操作

异常现象 #

仅在**iPhone15 Pro（iOS17.3.1）**设备上出现问题：

• 启动应用后通过语音调用Siri，收到提示：[应用名] hasn't added support for that with Siri
• 直接通过Siri调用已添加的快捷方式，也收到相同提示

iOS16.3.1的iPad设备上运行正常，两台设备设置一致。

排查方向 #

1. 检查意图扩展的部署目标
   确认意图扩展的Deployment Target是否设置为iOS17及以下（不高于设备系统版本），iOS17对Siri扩展的签名和兼容性要求更严格，若扩展部署目标高于设备系统版本，会导致无法被加载。

2. 验证意图定义文件的兼容性
   打开.intentdefinition文件，检查每个自定义意图的配置：

   • 确认Intent is eligible for Siri选项已勾选
   • 核对Supported Phrases是否包含足够清晰的语音触发短语，iOS17对语音匹配的准确性要求更高，避免短语过于模糊或与系统指令冲突
   • 检查意图的参数配置是否完整，确保每个必填参数都有对应的语音提示或默认值

3. 重新签名与安装
   iOS17对应用签名的完整性要求更严格，尝试以下操作：

   • 删除设备上的应用和意图扩展，清理Xcode缓存（Cmd+Shift+K）
   • 重新生成签名证书和描述文件，确保主应用和意图扩展使用同一开发者账号的签名
   • 重新打包安装到iPhone15 Pro设备

4. 检查iOS17的Siri隐私设置
   前往设备设置 > Siri与搜索 > [你的应用名]，确认：

   • Siri与搜索权限已开启
   • 允许Siri建议、在应用中显示Siri建议等选项均已启用
     iOS17新增了更细粒度的Siri权限控制，可能存在权限未完全开启的情况

5. 验证意图扩展的启动日志
   连接iPhone15 Pro到Xcode，打开控制台（Console），搜索意图扩展的Bundle ID，查看是否有启动失败、加载错误的日志信息（比如签名校验失败、类找不到等异常），这些日志能直接定位问题根源。

6. 检查NSUserActivity的注册逻辑
   确保在应用启动或合适时机，正确注册自定义NSUserActivity，iOS17要求NSUserActivity必须在应用启动后主动注册，才能被Siri识别，示例代码：

   let activity = NSUserActivity(activityType: "com.yourapp.YourCustomIntent")
   activity.title = "你的意图名称"
   activity.isEligibleForSearch = true
   activity.isEligibleForPrediction = true
   userActivity = activity
   userActivity?.becomeCurrent()
   

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