iOS/Swift项目中自定义Uniform Type Identifier(UTI)图标不显示问题

我之前在适配iPad的iOS 11 Swift应用里也碰到过一模一样的UTI图标不显示问题，折腾了好一会儿才搞定，给你梳理几个关键的排查和修复步骤：

• 确保Info.plist里的UTI配置完整且正确
  首先要确认你在Info.plist里的CFBundleDocumentTypes和UTExportedTypeDeclarations配置没有遗漏关键项。特别是UTI声明里的UTTypeIcon（iOS 11+推荐字段）必须正确指向你的图标文件。举个配置示例：

  <key>UTExportedTypeDeclarations</key>
  <array>
      <dict>
          <key>UTTypeIdentifier</key>
          <string>com.yourapp.customuti</string>
          <key>UTTypeDescription</key>
          <string>自定义格式文件</string>
          <key>UTTypeConformsTo</key>
          <array>
              <string>public.data</string>
          </array>
          <key>UTTypeIcon</key>
          <dict>
              <key>UTTypeIconName</key>
              <string>CustomDocumentIcon</string>
          </dict>
      </dict>
  </array>
  

  注意：UTTypeIconName直接用图标名称即可（不用加后缀，系统会自动匹配@2x、@3x版本）。

• 检查图标文件的规格和放置位置
  自定义文档图标需要准备多分辨率版本适配不同场景：

  • 常规尺寸：60x60pt（@2x:120x120px，@3x:180x180px）
  • 小图标：29x29pt（@2x:58x58px，@3x:87x87px）—— 文件应用的列表视图会用到这个尺寸
    把这些图标放到项目的Assets.xcassets中，或者作为资源文件添加到项目，务必勾选对应的Target Membership，确保图标被打包进应用。格式优先选PNG，避免使用复杂的带透明通道的特殊格式。

• 验证CFBundleDocumentTypes的关联配置
  在CFBundleDocumentTypes里，要同步配置图标信息，让系统明确应用与该UTI的关联及显示图标：

  <key>CFBundleDocumentTypes</key>
  <array>
      <dict>
          <key>CFBundleTypeName</key>
          <string>自定义格式文件</string>
          <key>CFBundleTypeRole</key>
          <string>Editor</string>
          <key>LSHandlerRank</key>
          <string>Owner</string>
          <key>LSItemContentTypes</key>
          <array>
              <string>com.yourapp.customuti</string>
          </array>
          <key>CFBundleTypeIconFiles</key>
          <array>
              <string>CustomDocumentIcon</string>
          </array>
      </dict>
  </array>
  

  这里CFBundleTypeRole设为Editor或Viewer，LSHandlerRank设为Owner，确保你的应用是该UTI的默认处理者。

• 清理缓存并重新安装应用
  iOS调试阶段很容易缓存旧的图标信息，你可以按以下步骤操作：

  • 从iPad上彻底删除应用
  • 清理Xcode的Derived Data（路径：Xcode -> Preferences -> Locations -> Derived Data，打开文件夹后删除对应项目的目录）
  • 重启iPad
  • 重新编译安装应用，再去文件应用查看图标状态

• 排查UTI唯一性与打包状态
  确保你的自定义UTI没有和系统已有的UTI冲突（比如不要用public.xxx这类系统前缀）。另外可以通过Xcode的Build Phases -> Copy Bundle Resources确认图标文件已经被正确添加到打包列表中。

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