ente Ensu iOS 应用图标更新指南从 1024×1024 透明前景图到 Any / Dark / Tinted 三变体的完整流程【免费下载链接】ente End-to-end encrypted cloud for everything.项目地址: https://gitcode.com/GitHub_Trending/en/enteEnsu 是 ente 生态中的 iOS 应用源码位于 apple/apps/ensu其中 README.md 记录了其基于 Rust 的端侧模型推理构建方式。本文以仓库文档 apple/apps/ensu/docs/app-icon.md 为核心骨架结合 AppIcon.appiconset 资产目录的真实结构与源码系统讲解 Ensu iOS 应用图标从源图准备、三变体导出到资产目录落地的完整更新流程。读完本文你将掌握 iOS 图标 Any / Dark / Tinted 三种外观变体的生成规格、背景色取值原理以及如何在 Xcode 中重建应用验证图标生效。背景为什么一颗 iOS 图标要准备三份变体从 iOS 13 开始系统会根据用户当前的外观模式浅色 / 深色 / 强调色对应用图标进行动态适配Apple 通过资产目录Asset Catalog的appearances声明支持三种外观变体变体语义触发场景Any任意默认外观浅色模式下展示的常规图标Dark深色深色外观系统处于深色模式时展示的图标Tinted着色强调色外观系统对图标进行着色/染色处理时使用的基础素材ente 仓库中 Ensu 的 AppIcon.appiconset/Contents.json 正是按这一模型组织的IconOGAny.png不带appearances声明默认外观IconOGDark.png声明了luminosity / darkIconOGTinted.png声明了luminosity / tinted。Ensu 采用的设计策略是只用一份 1024×1024 的透明前景图前景居中、画布为正方形在此基础上叠加不同的背景色导出三份变体而不是为每个变体单独绘制整套图标。这样既保证了三份素材在图形上完全一致视觉上仅背景不同又让深色模式和着色模式下系统能自行叠加各自的背景与染色效果。源图规范1024×1024 透明前景更新图标的第一步是准备源图。文档明确规定源图必须满足以下三点透明背景前景图形必须放在透明背景上背景不能有任何颜色或杂边否则叠加背景色时会污染最终图标1024×1024 画布前景必须居中放在一块 1024×1024 的正方形画布上这是 iOS 单尺寸通用图标single size universal icon的标准规格不留内边距如果源图尺寸不是 1024×1024应先把源图整体缩放rescale到 1024×1024而不是通过加 padding 撑大画布——加 padding 会让前景在后续圆角裁剪和缩略展示时显得偏小。从源码结构看Ensu 的前景素材在 EnsuLogoForeground.imageset 中存放了一份 432×432 的EnsuLogoForeground.png白色 ensu 字标风格的透明前景可以推断它是图标前景图形的候选来源之一——若以它为基础制作 1024×1024 图标就需要按上述规则放大到目标画布。三变体导出规格源图就绪后需要导出以下三份 1024×1024 变体变体文件名背景处理设计意图AnyIconOGAny.png#FFEEDD米白/奶油色不透明背景作为浅色模式默认图标自带浅色底与深色前景形成对比DarkIconOGDark.png透明背景保留透明让系统在深色模式下自行叠加深色渐变背景避免图标在深色模式中显得突兀TintedIconOGTinted.png白色背景白色底保证系统着色tinting时前景与背景的关系正确染色后依然可读三份文件同为 1024×1024 PNG替换时只需覆盖同名文件即可当前仓库中三个文件均为 1024×1024 尺寸符合规格。资产目录落地AppIcon.appiconset 结构与 Contents.json三份变体导出后需要放到资产目录apple/apps/ensu/Ensu/Assets.xcassets/AppIcon.appiconset/ ├── Contents.json ├── IconOGAny.png ├── IconOGDark.png └── IconOGTinted.png其中Contents.json是资产目录的描述文件Xcode 依据它把文件名与外观声明绑定起来。Ensu 当前的 Contents.json 内容如下{ images : [ { filename : IconOGAny.png, idiom : universal, platform : ios, size : 1024x1024 }, { appearances : [ { appearance : luminosity, value : dark } ], filename : IconOGDark.png, idiom : universal, platform : ios, size : 1024x1024 }, { appearances : [ { appearance : luminosity, value : tinted } ], filename : IconOGTinted.png, idiom : universal, platform : ios, size : 1024x1024 } ], info : { author : xcode, version : 1 } }关键字段说明idiom: universalplatform: iossize: 1024x1024声明这是适用于所有 iOS 设备的单尺寸通用图标appearances可选字段luminosity / dark表示深色变体luminosity / tinted表示着色变体不写该字段即默认的 Any 变体文件名必须与磁盘上的实际文件一一对应若导出时改了文件名需要同步修改这里的filename字段。需要留意的是替换图标时只动 AppIcon.appiconset 即可同目录下的 AppIconMac.appiconset 是 macOS 平台的图标集合含 16×16 到 512×5122x 共 10 个规格与 iOS 图标流程相互独立除非同时维护 macOS 端否则无需改动。五步操作流程综合 app-icon.md 的步骤完整更新流程如下打开透明源 PNG确保源图是带透明通道的 PNG非 JPGJPG 无法保存透明信息。居中与缩放确认前景在 1024×1024 画布上居中若源图尺寸不同先整体缩放rescale到 1024×1024不要通过添加 padding 来凑尺寸。导出三份变体IconOGAny.png叠加#FFEEDD背景IconOGDark.png保持透明背景让系统深色渐变透出IconOGTinted.png叠加白色背景保证着色行为正确。替换资产目录文件将三份 PNG 覆盖写入 Ensu/Assets.xcassets/AppIcon.appiconset/保持文件名不变若变更文件名需同步更新 Contents.json 的filename字段。在 Xcode 中重建应用重新编译使资产目录刷新新图标才会被打进产物。重建与验证文档强调第 5 步必须**重建rebuild**应用因为资产目录Asset Catalog在编译期被压缩进 App 包仅刷新模拟器或切换前台不会重新生成图标。重建有两种方式Xcode 图形界面打开 Ensu.xcodeproj选择EnsuschemeBuild Run命令行终端构建参照 apple/apps/ensu/README.md 的 Terminal builds 一节例如在模拟器上构建安装cd apple/apps/ensu xcodebuild -scheme Ensu -destination platformiOS Simulator,nameiPhone 17 xcrun simctl install booted \ ~/Library/Developer/Xcode/DerivedData/Ensu-*/Build/Products/Debug-iphonesimulator/Ensu.app xcrun simctl launch booted io.ente.ensu验证要点浅色模式下主屏幕图标应显示 Any 变体米白底系统切换为深色模式后图标应变为 Dark 变体透明底叠加系统深色渐变桌面图标着色生效的场景下应表现为 Tinted 变体白底染色若图标仍显示旧图先确认资产目录文件已被覆盖再执行一次 Cleanxcodebuild clean后重新构建以排除编译缓存。注意事项与常见问题背景色必须严格按规格Dark 变体若误填了不透明背景深色模式下系统渐变无法透出图标会显得是贴上去的一块Tinted 变体若不用白底着色算法计算出的前景对比度可能异常。画布尺寸与内边距前景未满 1024×1024 或留有大量 padding会导致最终图标在系统圆角裁切、主屏幕缩略展示时视觉占比偏小。文件名一致性Assets 目录下 PNG 文件名与 Contents.json 的filename必须完全一致含大小写否则构建时报 None of the input catalogs contained a matching app icon 类错误或直接使用占位图标。缓存问题模拟器或真机偶发不刷新图标卸载 App 重装、或在 Xcode 中 Product → Clean Build Folder 后再构建即可。只改 iOS 图标若此次仅更新 iOS 图标无需触碰 AppIconMac.appiconset避免扩大改动面。小结Ensu 的图标更新策略可以概括为一句口诀一份 1024×1024 透明前景居中源图导出 Any#FFEEDD 底、Dark透明底、Tinted白底三份变体同名覆盖到 AppIcon.appiconset重建即生效。这一流程同样适用于 ente 仓库中其他 iOS 应用如 apple/apps/cast的图标维护只需将上述规格套用到对应应用的 Assets.xcassets 即可。【免费下载链接】ente End-to-end encrypted cloud for everything.项目地址: https://gitcode.com/GitHub_Trending/en/ente创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
