为基于文档的Mac OS 16应用添加自定义文档图标遇问题求助

一、Info.plist 配置校验 #

• 针对MacOS 16新规范：确认CFBundleDocumentTypes中对应文档类型的UTTypeIconName，需与Assets中定义的图标集名称完全一致，且该图标集包含前景、背景的多分辨率资源。
• 针对Legacy Icon：检查CFBundleTypeIconFiles指向的图标文件是否存在，且包含16x16、32x32、64x64等所有必要尺寸的资源。
• 验证UTExportedTypeDeclarations/UTImportedTypeDeclarations中的UTI配置，确保UTI唯一且与文档扩展名正确绑定。

二、Assets 图标配置检查 #

• 新规范文档图标需创建Symbol Icon Set，分别配置Foreground和Background层，确保1x、2x、3x分辨率的资源均已添加完整。
• Legacy Icon需使用Icon Set，不能缺失任何分辨率的图标文件，否则系统会 fallback 到默认图标。

三、系统缓存与测试环境修复 #

• 重置图标缓存：执行终端命令：

  killall Finder; killall Dock; rm -rf ~/Library/Caches/com.apple.iconservices.store; rm -rf /Library/Caches/com.apple.iconservices.store
  

  执行后重启Finder和Dock。
• 使用签名后的应用包测试，未签名应用可能无法加载自定义图标。
• 确保测试文件的扩展名与Info.plist中配置的UTI完全匹配，系统依赖扩展名关联文档类型。

四、项目打包配置验证 #

• 检查项目Build Phases的Copy Bundle Resources，确认图标文件已被添加，避免资源未打包进应用。
• 在Xcode Target配置的Document Types中，确认对应文档类型已勾选，且关联UTI无误。

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