一、快捷指令“与应用共享”和常规共享的差异及适配方法 #

核心差异 #

• 触发场景与筛选逻辑不同：
  • 常规共享是用户主动从任意App的系统共享面板唤起，只要Extension配置了对应UTI就能显示；
  • 快捷指令的“与应用共享”是作为自动化触发/动作使用，系统仅筛选明确支持快捷指令自动化交互的应用，只有系统内置应用（如Health）或深度集成快捷指令的第三方应用（如LinkedIn）会默认出现在列表，普通自定义Extension需要额外配置才能被识别。

让应用进入“与应用共享”列表的步骤 #

• 配置Extension的Info.plist：
  • 在NSExtension -> NSExtensionAttributes下，除了原有UTI规则，添加NSExtensionActivationSupportsImageWithMaxCount（按需设置数值，比如10），同时补充NSExtensionActivationSupportsText等通用类型，提升系统识别优先级；
  • 确保NSExtensionPrincipalClass指向正确的处理类，且该类实现NSExtensionRequestHandling协议，beginRequest(with:)方法至少保留空实现（系统会检查该方法是否存在）。
• 配置主App的Info.plist：
  • 添加NSUserActivityTypes数组，包含com.apple.shortcuts.actionextension，明确告知系统你的App支持快捷指令交互。

二、ActionExtension真机不显示及快捷指令报错的解决 #

问题原因 #

1. UTI规则逻辑缺陷：你当前的规则要求所有附件的所有UTI都必须兼容public.image，但真机上图片通常携带多个UTI（比如public.png和public.image），ANY语法在这种场景下可能触发错误判断，导致规则不匹配；
2. 真机签名/权限问题：模拟器不严格验证签名，真机上Extension必须和主App使用同一有效签名证书，否则会被系统屏蔽；
3. 系统缓存未清理：真机系统会缓存Extension信息，修改配置后未彻底清除缓存，导致新配置不生效。

具体解决办法 #

• 修正UTI规则：调整规则逻辑，适配多UTI场景。如果需要至少一个图片附件，用以下规则：

  SUBQUERY (
    extensionItems, $extensionItem,
    SUBQUERY (
      $extensionItem.attachments, $attachment,
      EXISTS ( $attachment.registeredTypeIdentifiers UTI-CONFORMS-TO "public.image" )
    ).@count >= 1
  ).@count >= 1
  

  若要求所有附件都是图片，保留@count == $extensionItem.attachments.@count，但将ANY改为EXISTS，避免多UTI数组的判断错误。
• 检查签名与配置：
  • 确认主App和Extension使用同一开发者/Ad Hoc签名证书，调试证书仅能在开发设备上使用；
  • 核对NSExtensionActivationRule的语法，确保括号、逗号、变量名完全正确（UTI规则语法非常严格，微小错误都会导致失效）。
• 清理真机缓存：
  • 删除主App和Extension，重启设备后重新安装；
  • 进入设置→快捷指令，清除快捷指令缓存（或重置快捷指令设置，记得提前备份）。
• 调试报错信息：连接真机后，在Xcode中选择Extension target运行，查看控制台日志，获取具体报错（如权限不足、UTI匹配失败），针对性修复。

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