已添加至Assets.xcassets，为何tvOS应用图标仍未在Apple TV显示？

问题现象 #

基于现有iOS项目新增tvOS target后，已在Assets.xcassets中配置tvOS应用图标资源，但在Apple TV模拟器或真机运行时，主屏幕上的应用图标始终显示为空白白色方块，同时操作资源目录时偶现“unassigned items”警告。

已执行操作 #

• 从iOS项目添加新的tvOS target
• 在Assets.xcassets中通过App Icons & Launch Images > New tvOS App Icon and Top Shelf Image创建Brand Assets文件夹，包含App Icon - App Store和App Icon两个分层图像槽
• 将对应尺寸的Large、Small PNG文件添加到分层槽中
• 部署应用至模拟器和真机，图标仍显示空白

排查与解决步骤 #

1. 严格匹配图标尺寸要求 #

tvOS应用图标尺寸必须完全符合官方规范，否则会被系统忽略：

• App Icon分层：
  • Small：83pt × 83pt（@2x 对应166×166像素）
  • Large：108pt × 108pt（@2x 对应216×216像素）
• App Icon - App Store分层：1024pt × 1024pt（@1x 对应1024×1024像素）
  检查你的PNG文件是否严格对应上述尺寸，避免缩放或裁剪错误。

2. 确认图标资源绑定tvOS target #

打开Assets.xcassets，选中Brand Assets文件夹，查看右侧**Target Membership**面板，确保已勾选你的tvOS target。未勾选的话，打包时系统不会将图标资源纳入tvOS应用包。

3. 修复“unassigned items”警告 #

该警告表示存在未正确分配到图像槽的无效资源，处理方式：

• 选中Assets.xcassets中的“unassigned items”，右键选择**Delete**移除
• 重新将正确尺寸的图标拖入App Icon和App Icon - App Store对应的分层槽，确保每个槽都显示正常预览图

4. 检查tvOS target的图标配置 #

• 打开项目设置，选中tvOS target，进入**General**标签页
• 在App Icons and Launch Images区域，确认App Icon Source已选择Brand Assets中的App Icon，而非空选项或错误资源

5. 清理缓存后重新构建 #

• 执行Xcode菜单**Product > Clean Build Folder**（快捷键：Shift+Command+K）
• 关闭模拟器/断开真机连接，重启Xcode
• 重新构建并部署应用，查看图标是否正常显示

6. 验证图标文件格式与完整性 #

确保图标为PNG格式，无文件损坏情况；虽然tvOS支持透明图标，但如果图标全透明会显示白色方块，需检查图片的alpha通道是否正常。必要时重新导出图标文件。

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