如何用Xcode调试Quick Look Preview Extension？遇空窗及命令报错

问题背景 #

在Xcode中启动Quick Look Preview Extension目标后，Quick Look Simulator应用窗口几乎为空；尝试用终端命令qlmanage测试时，执行qlmanage -p /path/to/previewed/file -c public.text -g /path/to/QuickLookPreviewExtension.appex（其中.appex文件来自Xcode构建的DerivedData文件夹），出现错误：Can't get generator at QuickLookPreviewExtension.appex。

一、修复qlmanage命令的使用问题 #

• 用绝对路径指定.appex文件：确保路径是完整的绝对路径，比如~/Library/Developer/Xcode/DerivedData/YourApp-xxxx/Build/Products/Debug-iphonesimulator/YourExtension.appex，避免相对路径导致的解析错误。
• 匹配扩展支持的文件类型：检查扩展Info.plist里的QLSupportedContentTypes字段，确认包含你测试的类型（比如public.text），类型不匹配会导致qlmanage无法识别生成器。
• 重置缓存并简化命令：先重置qlmanage的缓存，再尝试不指定-g参数让系统自动检测：

  qlmanage -r
  qlmanage -p /path/to/your/test.txt
  

二、在Xcode中直接调试扩展 #

• 配置调试的测试文件：
  1. 选中Quick Look Preview Extension目标，进入Edit Scheme。
  2. 在Run选项卡的Info部分，将Executable设置为Quick Look Simulator（找不到的话，选Other后在/Applications/Xcode.app/Contents/Developer/Applications/路径下查找）。
  3. 在Arguments部分添加--file参数，后面跟上测试文件的绝对路径，比如--file /Users/xxx/test.txt。
• 断点调试核心逻辑：在PreviewViewController的preparePreviewOfFile等关键方法中设置断点，启动调试后，Quick Look Simulator会加载指定文件并触发扩展代码，断点生效后即可排查逻辑问题。

三、排查扩展本身的配置与构建问题 #

• 检查Info.plist配置：确认NSExtension字典下的NSExtensionPointIdentifier为com.apple.quicklook.preview，QLSupportedContentTypes的类型没有拼写错误。
• 验证构建状态：查看Xcode的Report Navigator构建日志，确认扩展无编译错误，生成的.appex文件完整。
• 测试多类型文件：换几种符合QLSupportedContentTypes的文件测试，排查是否是特定类型的处理逻辑出错。

四、通过系统日志定位问题 #

打开Console应用，搜索QuickLook或你的扩展名称，查看加载失败、权限问题或代码崩溃的相关日志，这些信息能直接帮你定位具体故障点。

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