AppIcon.appiconset，拖进 Xcode 即用。

什么是 AppIcon.appiconset？

在 Xcode 里，App 图标不是散落的 PNG，而是一个名为 AppIcon.appiconset 的资源文件夹。它包含两部分：描述清单 Contents.json，和若干按「设备 idiom + 逻辑尺寸 + 倍率 scale」命名的位图。Xcode 读取 Contents.json，把每张图对应到正确的设备与场景（主屏、Spotlight、设置、App Store 等）。只要文件夹结构正确，拖进 Assets.xcassets 即可被工程识别。

Contents.json 长什么样

Contents.json 用 images 数组把每个 idiom / 尺寸 / 倍率映射到一个文件名，info 标注版本与作者。下面是与本工具输出一致的示例（节选）：

{
  "images" : [
    { "idiom" : "iphone", "size" : "20x20", "scale" : "2x", "filename" : "icon-20@2x.png" },
    { "idiom" : "iphone", "size" : "60x60", "scale" : "3x", "filename" : "icon-60@3x.png" },
    { "idiom" : "ipad", "size" : "76x76", "scale" : "2x", "filename" : "icon-76@2x.png" },
    { "idiom" : "ios-marketing", "size" : "1024x1024", "scale" : "1x", "filename" : "icon-1024.png" }
  ],
  "info" : { "version" : 1, "author" : "tushuo" }
}

filename 必须与文件夹内实际 PNG 名一致；同一张图可被多个 idiom 复用（例如 40@2x 同时用于 iPhone 与 iPad 的 Spotlight）。

图标不显示 / 构建报错时怎么查

iOS 图标的坑几乎都集中在三处：文件名、尺寸和 App Icon 名称。按下面顺序排查基本都能定位。

如何导入 Xcode

1. 下载 ZIP 并解压，得到 AppIcon.appiconset 文件夹。
2. 在 Xcode 打开工程，定位到 Assets.xcassets。
3. 把整个 AppIcon.appiconset 文件夹拖入 Assets.xcassets（替换已有的 AppIcon）。
4. 在 Target → General → App Icons and Launch Screen 里确认 App Icon 名称为 AppIcon。
5. 运行到模拟器 / 真机，主屏图标即生效；上传 App Store 时会使用 1024 营销图。

常见问题