如何为iOS应用自定义导出文档类型设置专属图标？

问题场景 #

通过info.plist配置UTExportTypeDeclarations和CFBundleDocumentTypes实现自定义文档导出时，遇到以下问题：

• 基于public.text的UTI类型，在消息附件中始终显示通用文本文档图标，自定义图标不生效
• 尝试过CFBundleTypeIconFiles/CFBundleTypeIconFile键，无论是资源包文件名还是Asset Catalog名称都无效
• 不清楚需要准备哪些尺寸的图标
• 设置图标键后系统状态异常，原本可用的AppIcon默认图标失效，恢复需重置系统

正确配置步骤 #

1. 图标资源准备 #

必须提供完整尺寸的PNG图标集，覆盖iOS全设备分辨率：

• 小尺寸：16x16 (@1x)、32x32 (@2x)、64x64 (@3x)
• 大尺寸：128x128 (@1x)、256x256 (@2x)、512x512 (@3x)
• 图标不要自带圆角，系统会自动添加；避免透明背景外的多余元素
• 不要放入Asset Catalog，直接放在项目根目录或独立资源文件夹，确保打包时被加入Copy Bundle Resources

2. Info.plist精准配置 #

• 在CFBundleDocumentTypes的目标文档类型字典中，配置CFBundleTypeIconFiles为数组，填入不带后缀的图标文件名（例如图标文件名为CustomTextDoc.png，则填CustomTextDoc）
• 确保UTExportTypeDeclarations中的UTI与CFBundleDocumentTypes的LSItemContentTypes完全对应
• 示例配置片段：

<key>CFBundleDocumentTypes</key>
<array>
    <dict>
        <key>CFBundleTypeName</key>
        <string>自定义文本文档</string>
        <key>CFBundleTypeIconFiles</key>
        <array>
            <string>CustomTextDoc</string>
        </array>
        <key>LSItemContentTypes</key>
        <array>
            <string>com.yourcompany.customtext</string>
        </array>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
    </dict>
</array>
<key>UTExportTypeDeclarations</key>
<array>
    <dict>
        <key>UTTypeIdentifier</key>
        <string>com.yourcompany.customtext</string>
        <key>UTTypeConformsTo</key>
        <array>
            <string>public.text</string>
        </array>
        <key>UTTypeDescription</key>
        <string>自定义文本文档</string>
        <key>UTTypeTagSpecification</key>
        <dict>
            <key>public.filename-extension</key>
            <array>
                <string>ctxt</string>
            </array>
        </dict>
    </dict>
</array>

3. 系统缓存异常修复 #

无需重置系统，按以下步骤操作即可恢复：

• 删除设备上的当前App
• 重启iPhone/iPad
• 重新安装App
• 可选：进入「设置」->「通用」->「传输或还原iPhone」->「还原」->「还原主屏幕布局」，彻底清理图标缓存
• 若仍有问题，暂时关闭iCloud云盘的文档同步，重启后再重新开启

核心注意事项 #

• 基于public.text的UTI会继承系统默认文本图标，必须确保图标资源完整、配置正确，才能覆盖系统默认
• iOS仅支持CFBundleTypeIconFiles数组键，不要使用macOS专属的CFBundleTypeIconFile单值键
• 打包前务必确认图标已被添加到Copy Bundle Resources列表中，避免资源缺失

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