MacOS下签名应用无法加载QuickLook扩展(Plugin)问题求助

以下是几个经过验证的排查和解决步骤：

• 确保主应用与扩展使用同一签名身份并完整签名
  很多时候问题出在签名不完整：要么只签了主应用没签嵌套的扩展，要么用了不同的证书签名。

  • 用Xcode签名时，确保主应用和扩展目标的Signing & Capabilities里选择了同一个开发者ID或团队。
  • 手动签名的话，先单独签名扩展：codesign -s "你的签名身份" --entitlements Extension.entitlements /path/to/your/app.app/Contents/PlugIns/YourQLExtension.qlgenerator，再签名主应用：codesign -s "你的签名身份" --entitlements App.entitlements /path/to/your/app.app。避免直接用--deep签名，容易导致嵌套代码签名失效。

• 检查并修正扩展的Entitlements配置
  默认生成的权限可能在签名后（尤其是沙箱启用时）不足以让扩展正常工作：

  • 如果主应用启用了沙箱，扩展必须同样启用沙箱，并且添加必要的文件访问权限：比如com.apple.security.files.user-selected.read-only（允许读取用户选择的文件），如果需要访问特定目录，还要添加对应的沙箱权限。
  • 确保扩展的Entitlements文件中包含com.apple.developer.quicklook.preview权限（Xcode默认添加，但手动签名时要确认该文件被正确嵌入）。
  • 主应用和扩展的沙箱配置要保持一致，不能一个开沙箱一个不开。

• 重置QuickLook缓存
  系统的QuickLook缓存可能保留了旧的未签名扩展信息，导致新签名的扩展不加载：
  打开终端执行以下命令：

  qlmanage -r
  qlmanage -r cache
  killall Finder
  

  注销并重新登录效果更好。

• 验证签名的有效性
  用终端命令检查签名是否存在问题：

  codesign -vvv --deep --strict /path/to/your/app.app
  

  查看输出中的错误信息，比如invalid signature、entitlements not valid、resource modified等，这些会直接告诉你签名失败的原因。

• 检查Info.plist配置
  确认扩展的Info.plist没有被签名过程篡改：

  • 确保NSExtension -> NSExtensionPointIdentifier的值是com.apple.quicklook.preview。
  • 确认NSExtensionPrincipalClass指向的类名正确（比如$(PRODUCT_MODULE_NAME).PreviewViewController），没有拼写错误。

• 查看系统日志定位具体错误
  打开「控制台」应用，搜索qlmanage或你的扩展名称，查看加载失败时的具体报错：

  • 比如Sandbox restriction表示沙箱权限不足，Code signature invalid表示签名验证失败，Could not load class表示类加载错误，这些日志能帮你快速定位问题根源。

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