创建 iOS 或 Mac 应用图标

资源目录是伪装成文件的文件夹

当你在 Xcode 项目导航栏中看到 Assets.xcassets 时，它并非单个文件——而是磁盘上的一个目录。在其中，你添加的每一张"图片"都有自己的子目录，包含实际的 PNG 文件和一个小型 Contents.json，用于告知构建系统哪个文件对应哪种尺寸、缩放比例和设备类型（iPhone、iPad、Mac 等）。

对于应用图标，该目录命名为 AppIcon.appiconset。旧版流程中，它会包含约 15 张覆盖所有设备像素尺寸的 PNG。自 Xcode 14 起，现代流程支持"单一尺寸"模式：只需放入一张 1024×1024 的 PNG，工具链会在构建时自动生成每个较小的变体。你不需要交付 15 个文件——只需一个。

这正是"用这张图片作为应用图标"这类提示词对智能体如此奏效的根本原因——只需写入一个文件，编辑一个 Contents.json。

三条规则，其中一条会导致构建被拒

你的 1024×1024 源 PNG 需要满足三个条件：

• 精确为 1024×1024 像素，且为正方形。不能是 1023×1024，也不能是 2048×2048 缩小版。Xcode 会发出警告但仍会发布；App Store Connect 在上传时若发现不是正方形则会直接拒绝。
• sRGB 色彩空间。如果你从 Figma 或 Sketch 导出，几乎可以肯定已经是 sRGB。如果从印刷工具导出，可能是 Display P3 或 Adobe RGB——导入前请先转换，否则颜色在设备上会出现偏差。
• 不含 alpha 通道。这是最隐蔽的问题。App Store Connect 会拒绝任何带有透明度的 iOS 图标——而且是在漫长的等待之后，在上传最后阶段才报错。请在保存前将图片合并到纯色背景上（通常是白色或品牌色）。

另外：不要提前圆角化。iOS 和 macOS 会应用各自的圆角蒙版（不同平台、不同设备家族的圆角半径各有差异）。如果你交付一个已经圆角化的正方形，最终会得到一个"双重圆角"的效果，在所有设备上看起来都不对劲。请交付完整的正方形；操作系统会完成剩余的处理。

Mobile 菜单 → 应用图标生成器… → 输入提示词或粘贴图片 → 生成

LingCode 提供了一个专用面板，可在一个窗口内完成整个流程——生成源图片、调整为所有必要尺寸、写入资源目录。从菜单栏选择 Mobile → App Icon Generator…。

你有两种方式提供源图片：

• 输入提示词：文本框支持自然语言输入（"简约紫色闪电，扁平设计，白色背景"），调用 LingCode 托管的图片生成后端生成 1024×1024 的 PNG。文本框上方的配额标记显示本月剩余的生成次数——免费版/Pro/Max-Pro 各有不同的上限。
• 拖入主图片：如果你已经有来自 Figma、Midjourney、对话中 generate_image 工具或其他来源的 1024×1024 PNG，点击主图片槽位并选取文件即可。

然后选择目标目录——iOS 槽位指向项目的 Assets.xcassets/AppIcon.appiconset/，Android 槽位指向 app/src/main/res/（关闭不需要发布的平台即可）。点击生成。面板会列出写入的所有文件，以便你确认输出是否落到了正确的文件夹中。

该面板底层使用 LingCode 内置的 AppIconGeneratorService——纯 Core Graphics 实现，无需外部工具。iOS 通道会生成包含所有必要尺寸的完整 AppIcon.appiconset；Android 通道会在每个密度分组下写入 ic_launcher、ic_launcher_round 和自适应 ic_launcher_foreground（详见 Android 自适应图标教程）。

如果你更倾向于在智能体对话中操作

在项目中打开 Claude 对话，输入：

Add an app icon to this project. Use ~/Desktop/icon.png as the source image.
Use the modern single-size asset catalog flow (one 1024×1024 image).

智能体会将文件复制到 YourApp/Assets.xcassets/AppIcon.appiconset/icon.png，并重写 Contents.json 以声明单个 1024×1024 的通用条目。两处修改都会显示在差异视图中，可以方便地撤销。

还没有源图片？对话本身接入了 Gemini 图像模型的图片生成工具。输入"生成一个 1024×1024 的应用图标：深海军蓝背景上的金色几何太阳，扁平设计"，智能体会将结果保存到 <project>/assets/<slug>.png，并在对话中内联引用，方便你迭代。此功能需要你自己的 Gemini API 密钥（设置 → API Keys → Gemini）。满意后，让智能体将其接入资源目录——或打开应用图标生成器面板并指向生成的文件。

验证方法：在 Xcode（或 LingCode 的资源浏览器）中打开 Assets.xcassets，点击 AppIcon。你应该看到图片显示在一个大的单一槽位中，而不是分散在设备专属槽位的网格里。这就确认了单一尺寸模式已开启。

需要手动操作时

同样的流程，逐步点击完成。当某些设置发生偏移而差异不明显时非常有用。

1. 在 Xcode 中打开 Assets.xcassets。在左侧边栏选择 AppIcon 条目。
2. 在右侧检查器（属性）中，将设备设置为 iOS、iPadOS、macOS（根据需要选择）。
3. 开启单一尺寸（或"iOS Marketing"——取决于 Xcode 版本，二者含义相同）。
4. 将你的 1024×1024 PNG 拖入出现的单一槽位。
5. 构建并运行。确认图标出现在 Dock（Mac）或主屏幕（iOS 模拟器）中。

如果槽位提示"Image dimensions don't match expected size"，说明源图片不是精确的 1024 正方形。如果提示 alpha 相关问题，请参见第二步的警告框。

两种失败模式，各有一个明显症状

如果图标未出现或无法发布，几乎总是下面两种情况之一：

两种问题用智能体排查都只需 30 秒：将拒绝邮件或启动台症状粘贴到对话中，它会帮你检查 Contents.json 和构建设置。