AppStoreConnect上传Catalyst应用图标出现多余黑/灰边框如何解决

该问题由Mac Catalyst的图标渲染逻辑导致，与素材损坏、iOS端配置无关：iOS端App图标渲染逻辑会直接对素材做标准圆角裁切，不会额外添加效果；但Catalyst端会自动给带alpha透明通道的图标边缘添加一圈类似投影的灰/黑色描边，只要图标圆角外存在透明像素，就会触发这个自动描边逻辑，最终展示出异常边框。同素材在iOS端显示正常，正是因为iOS端不存在这个自动描边的渲染规则。

可按以下步骤操作解决：

• 不要直接复用iOS端的App Icon素材集给Catalyst target使用，单独为Mac Catalyst端创建独立的App Icon配置集
• 所有尺寸的Catalyst图标素材必须完全移除alpha通道，圆角外的区域不能留透明，要填充为和图标边缘匹配的不透明颜色：
  • 用Sketch、Figma等设计工具导出素材时，取消勾选「包含透明背景」「保留Alpha通道」选项
  • 用Mac自带预览App处理已有素材时，打开素材后依次点击「文件-导出」，取消勾选Alpha选项后保存覆盖原文件
  • 批量处理素材可直接在终端执行命令移除PNG文件的alpha通道：sips -s hasAlpha false 目标图标文件路径.png
• 回到Xcode配置页，选中Catalyst对应的target，在「General」标签页下找到「App Icons and Launch Screen」板块，确认Mac分类下选中的是刚配置的无alpha通道的专用Catalyst图标集，不要误选iOS端的图标集
• 上传前本地验证：导出ipa后解压，找到Payload目录下的.app包，右键选择「显示包内容」，找到对应的Mac端图标资源直接打开查看，如果素材本身无透明区域、无自带边框，上传后就不会出现异常黑灰边

注意：不要提前给图标素材手动添加Mac风格圆角，Catalyst系统会自动给符合要求的无alpha图标套标准圆角，手动加圆角反而会导致圆角裁切错位、出现双边框问题。

内容的提问来源于stack exchange，提问作者Chris