1.
众所周知,在 Icon Composer 出现后,只需要把 .icon 放在 Target group 即可完成图标的配置,Xcode 会在编译时自动生成全尺寸的图标资源。
直到最近一次构建 Pencel 时,我的天塌了,App 包体直接大了 1MB,超出了我对它定下的 10MB 体积红线。
排查了一下构建产物,发现是 Assets.car 带来的体积增量。定位了一下变量,判断大概率是 Icon Composer 2.0 这个版本所致。
2.
Pencel 的图标其实不需要液态玻璃效果,使用 Icon Composer 完全是对于所谓「最佳实践」的畸恋,但在我对 App 体积的极致追求面前,也只能让让道了。
虽然传统 macOS App Icon set 有 16 – 512 point 的 1x / 2x 槽位,并且 Inspector 内的 macOS 选项也不像 iOS 一样有 Single Size 可选,但亲测 (Xcode 26.5),事实上只需要配置一张 512×512@2x 即可。
由于没有经历过 macOS 15 时代的桌面应用开发,我下意识地像开发 iOS 应用一样,配置了不带 Alpha 区域的无圆角图片资源。
结果是 macOS 26 和 27 上表现正常,自动剪裁为了圆角矩形,但在 15 和 TF 的更新通知邮件中 (是的,TF 通知邮件中的图标复用的是 15 的版本) ,表现为无圆角、大尺寸、方形图标。
我下意识的推断是,如果为 15 上的图标预留圆角和 Alpha 边距,那 26 和 27 上的图标表现显然又会出错,所以我一度怀疑这纯粹是官方图标产物的 Bug。
3.
但我又意识到,很多 15 时代过来的 App 在新系统上的图标表现并没有问题,这意味着新系统可能会对旧版本图标做适配。
按照官方 macOS Sequoia Production Template 中的标准参数:
- 画布:
1024×1024px - 主体:
824×824px,四周 Alpha 留空 - 圆角近似:Smooth Corner Radius
185 px - 投影近似:
.black.opacity(0.3), radius: 5, x: 0, y: 10

适配后再构建,在 15、26 和 27 上的表现果然都恢复了正常。
包体也回到了 9MB 上下,心满意足。
4.
捋一下时间线就容易理解了。
大一统的圆角矩形图标可以追溯到 Big Sur,但在 Tahoe 之前,还只是软性的推荐范式,模版内留出的 Alpha 区域是官方允许出格的绘制空间。 不得不说,还是最喜欢这段统一又不失活力的时期。
在 Tahoe 及其之后,圆角矩形成为硬性标准,Icon Composer 成为推荐配置手段。
唯一的缺口就是像我这样还在通过 App Icon set 来配置同时还兼容老系统的 case。