现代 Xcode：一张 1024×1024 通用图标
生成一张不透明的默认外观 PNG 与通用 iOS 清单项，由 Xcode 创建更小的设备版本。
1 PNG · 1024×1024 · universal
Xcode Asset Catalog 构建工具
Xcode App Icon 生成器
用一张图标生成完整的 AppIcon.appiconset、匹配的 PNG 和 Contents.json。
可选择现代 Xcode 的 1024×1024 单尺寸工作流，也可导出经典的 iPhone、iPad 与 App Store 全尺寸兼容槽位。所有图片都会合成为不透明方形文件，并在浏览器本地完成打包。
现代 1024 单尺寸18 个兼容槽位包含 Contents.json浏览器本地处理
Xcode Asset Catalog 工作台 / 本地会话
为 Xcode 上传 1024×1024 App 图标
建议使用已经完成设计的方形母版。1024px 或更大的位图可避免放大；SVG 也能清晰生成每个兼容槽位。
PNG · JPG · WEBP · SVG / 最大 10 MB / 推荐 1024×1024
选择 Xcode 输出契约
Xcode App Icon 尺寸：现代单尺寸与全尺寸兼容模式
现代 Xcode 可以用一张 1024×1024 图片派生 iPhone 与 iPad 版本。兼容模式适合仍保留明确 point 与 scale 槽位的项目，或需要针对小尺寸调优图稿的团队。
18 个兼容输出是目录槽位，不是 18 个必需设计。当前 Xcode 的 All Sizes 目录允许槽位留空；对大多数新的 iOS 项目来说，Single Size 是更简洁的默认选择。
Xcode 全尺寸：iPhone、iPad 与 App Store 槽位
生成完整的经典 18 槽位矩阵，让每个 idiom、point 尺寸和 scale 都有对应的命名 PNG。
8 iPhone · 9 iPad · 1 App Store
| 选择依据 | 现代单尺寸 | 全尺寸兼容 |
|---|---|---|
| 适用场景 | 拥有一张完整 1024px 母版的新 iOS 与 iPadOS 项目 | 旧目录、交付包，或需要针对小尺寸调优的项目 |
| PNG 输出 | 1 张通用 1024×1024 PNG | 覆盖 13 种唯一像素尺寸的 18 个槽位文件 |
| 清单映射 | universal + iOS platform + 1024 size | iPhone、iPad、iOS marketing 的 idiom、point 尺寸与 scale |
| 图稿控制 | 同一外观用于所有派生尺寸 | 小槽位需要特殊细节时，可以在 Xcode 中单独替换文件 |
从 ZIP 到 Asset Catalog
如何将 AppIcon.appiconset 添加到 Xcode
下载包解压后直接得到资源集文件夹。请让 PNG 与 Contents.json 始终保持在一起，Xcode 才能解析每个清单项。
- 01
下载并解压 App 图标集
选择模式生成后，下载 AppIcon.appiconset.zip；解压时不要重命名或拆散里面的文件。
- 02
在 Xcode 中打开 Assets.xcassets
在项目导航器中打开分配给应用 target 的 Asset Catalog，并找到现有的 AppIcon 资源集。
- 03
替换现有 AppIcon.appiconset
结束正在进行的文件重命名后，把生成的文件夹拖入 Asset Catalog，或在项目中替换同名目录。
- 04
构建并检查 Target
确认 target 的 App Icons Source 指向 AppIcon，然后构建项目，并在支持的设备与外观中检查图标。
清单结构
Contents.json 如何映射 Xcode App Icon 尺寸
Xcode 会读取清单，而不是根据文件名猜测尺寸。每个 images 项都声明对应的目录槽位，filename 再把该槽位连接到 Contents.json 同目录下的 PNG。
AppIcon.appiconset / Contents.json
{
"images": [{
"filename": "AppIcon-1024.png",
"idiom": "universal",
"platform": "ios",
"size": "1024x1024"
}],
"info": { "author": "xcode", "version": 1 }
}filename
引用同一 AppIcon.appiconset 目录内的 PNG。打包前会检查每个引用是否存在。
idiom 与 platform
现代输出使用 universal idiom 与 iOS platform；兼容输出则标记 iPhone、iPad 或 iOS marketing。
size 与 scale
兼容槽位使用 point 和 @1x、@2x、@3x；两者相乘就是对应 PNG 的像素尺寸。
info
目录元数据将 author 声明为 xcode、格式版本声明为 1，符合 Asset Catalog 约定。
第一次构建前
Xcode App Icon 导出检查清单
生成器解决文件和清单工作，但仍应进行简短的视觉检查，确保图标适用于系统遮罩、设备与 App Store 展示。
使用不透明的完整方形设计
不要保留透明边缘。所选背景会合成到每张 PNG 后面，确保 Xcode 输出没有 Alpha 通道。
不要预先烘焙圆角
导出画布应保持方形。iOS 会应用自己的遮罩，提前做圆角可能产生边框或双重圆角。
将深色与着色版本视为独立图稿
当前首版只生成默认外观，不会把同一张图复制成不真实的 Dark 或 Tinted 变体。
在你的 Xcode 项目中验证
检查 target 设置、目录警告、设备预览与真实构建。自动资源包检查不能替代项目级验收。
外观变体
包含默认外观；Dark 与 Tinted 保持可选
没有自定义变体时，系统可以自动派生。规范的 Dark 图稿可能使用透明背景，Tinted 图稿应为灰度图，因此无法从所有扁平源图中诚实地自动还原。
Apple 分层图标
这里生成的不是 Icon Composer .icon 文件
Apple Icon Composer 会保留图层与 Liquid Glass 调整。扁平图片无法恢复这些结构，所以本工具明确导出传统 AppIcon.appiconset。
不同输出任务
Xcode 生成器、跨平台生成器与 Resizer 的区别
需要专用 Xcode Asset Catalog 时使用本页；需要 iOS 加 Android 资源时选择跨平台生成器；只需要不含目录元数据的独立 PNG 尺寸文件时选择 Resizer。
Apple 官方 Xcode App Icon 与 Asset Catalog 参考
本页的模式、术语与注意事项已对照 Apple 指南审查。针对你的 Xcode 版本与 target，最终仍以真实项目构建结果为准。
Xcode App Icon 生成器常见问题
关于 1024×1024 源图、Single Size、兼容槽位、透明度、Contents.json、Icon Composer 与本地处理的解答。
应该向 Xcode App Icon 生成器上传多大的图片？
请使用 1024×1024 的方形 PNG、JPG 或 WebP，也可以上传能在该尺寸下清晰渲染的 SVG。较小的位图可以放大，但生成的 1024px App Store 图片无法恢复源文件中缺失的细节。
现代 Xcode 需要所有 iPhone 与 iPad App 图标尺寸吗？
不需要。现代 Xcode 支持 Single Size 工作流，从一张 1024×1024 图标派生较小版本。只有当项目或交付流程需要明确的 point 与 scale 槽位时，才选择全尺寸兼容模式。
18 张兼容 PNG 都是 Apple 必需的吗？
不是。它们代表完整的经典 iPhone、iPad 与 App Store 槽位矩阵，并不等于 18 个普遍必需的设计。当前 Xcode 的 All Sizes 目录允许槽位留空；本工具填满矩阵，是为了提供自包含的兼容资源包。
Xcode App 图标可以使用透明背景吗？
默认 App 图标不应依赖透明背景，因此本生成器会把所有 PNG 合成到所选的不透明颜色上。自定义 Dark 外观图稿遵循不同规则，本首版不会生成。
生成器会给 PNG 文件添加圆角吗？
不会。所有导出的 PNG 都保持完整方形。预览中的圆角轮廓只是展示系统遮罩可能如何裁切图稿，真正的遮罩由 iOS 在显示时应用。
AppIcon.appiconset 中的 Contents.json 有什么作用？
它把每个 PNG 文件名映射到 Asset Catalog 槽位。现代输出使用 universal iOS 1024 项；兼容输出则记录每个 iPhone、iPad 与 App Store 槽位的 idiom、point 尺寸与 scale。
这个工具会生成 Dark、Tinted 或 Icon Composer 资源吗？
不会。它只在传统 AppIcon.appiconset 中生成默认外观，不会把图稿复制成误导性的 Dark 或 Tinted 变体，也无法创建 Apple Icon Composer 生成的分层 .icon 文件。
我的 App 图标会上传到服务器吗？
不会。图片读取、SVG 清理、缩放、PNG 编码、清单创建、预览和 ZIP 打包都在浏览器中完成，LogoFoundry 不会接收或存储你选择的图稿。