macOS Shortcuts的Intents Extension运行时启动主应用无法独立执行问题

触发原因 #

该问题是由Intent配置或扩展配置不匹配导致的，系统无法识别到可处理对应Intent的扩展，就会默认跳转主应用处理。

修复步骤 #

• 检查Intent Definition文件的Target成员资格：右键点击.intentdefinition文件，选择「显示文件检查器」，在「Target 成员资格」栏同时勾选主应用和Intents Extension两个target，保证两端都能读取到Intent的定义规则。
• 检查自定义Intent的处理属性：打开.intentdefinition文件，选中对应的自定义Intent，在右侧属性检查器的「自定义Intent」区域，勾选Intent is handled by an extension（Intent由扩展处理）选项，不要勾选主应用处理的相关选项。
• 校验Intents Extension的Info.plist配置：打开Extension target的Info.plist文件，展开NSExtension -> NSExtensionAttributes -> IntentsSupported数组，确认数组内已添加自定义Intent的完整类名，拼写、大小写和Intent Definition中的定义完全一致。
• 核对版本与签名配置：确认Intents Extension的部署目标（Deployment Target）设置为macOS 12.0及更低版本，和主应用的部署目标保持一致；同时确认Extension和主应用使用同一开发团队签名，避免权限不匹配。
• 清理缓存重试：所有配置修改完成后，按Cmd+Shift+K清理Xcode构建缓存，卸载设备上的旧版应用后重新编译运行，再测试快捷指令即可正常触发扩展执行，不会再跳转主应用。

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