如何为iOS 14+跨平台应用创建自定义文档图标

iOS 端出现该问题是因为你使用了iOS 13及更早版本的遗留配置逻辑，具体修复步骤如下：

• 移除当前UTExportedTypeDeclarations节点下的UTTypeIconFiles配置，该配置优先级高于iOS 14新增的组合图标配置，会导致系统直接渲染你提供的单张PNG，不会自动生成带背景、文本的标准文档图标。
• 新增和macOS端一致的UTTypeIcons字典节点，配置规则和macOS完全相同，示例如下：

<key>UTTypeIcons</key>
<dict>
    <key>UTTypeIconBackgroundName</key>
    <string>Icon Fill</string>
    <key>UTTypeIconBadgeName</key>
    <string>Icon Image</string>
    <key>UTTypeIconText</key>
    <string>Dapka</string>
</dict>

• 将配置中用到的背景图（Icon Fill）、徽章图（Icon Image）导入项目的Asset Catalog中，不要直接放在Resources文件夹，iOS 14+会优先从Asset Catalog读取图标资源。
• 若需要兼容iOS 13及更低版本，可以额外保留UTTypeIconFiles配置，放入已经提前合成好背景、徽章、文本的完整PNG图标，系统会自动根据当前系统版本选择对应渲染逻辑。

注意事项 #

• 资源名称的大小写必须和配置内容完全一致，iOS文件系统为大小写敏感。
• 背景图推荐使用1024*1024分辨率的PNG，徽章图使用透明底素材，尺寸不要超过背景图的60%，避免显示裁切。

内容的提问来源于stack exchange，提问作者Adam M.