为什么我的 tvOS 应用程序图标未显示在 Apple TV 上，尽管将其添加到 Assets.xcassets 中？

Question

我正在尝试将 tvOS 应用程序图标添加到我的项目中，但是当我在 Apple TV 模拟器或设备上构建并运行该应用程序时，该应用程序图标在 Apple TV 主屏幕上显示为空白（白色方块）。

这是我迄今为止尝试过的：

1. 我从现有的 iOS 项目开始，并添加了一个 新的 tvOS 目标。
2. 我进入 Xcode 中的 Assets.xcassets 文件，单击 + 按钮，然后选择：

   App Icons & Launch Images > New tvOS App Icon and Top Shelf Image

   。
3. 这创建了一个名为 Brand Assets 的文件夹，其中包含两个分层图像井：
   • 应用程序图标 - 应用程序商店
   • 应用程序图标
4. 我将适当的大和小PNG文件添加到各自的图层中。
5. 我构建了应用程序并将其部署到 Apple TV 模拟器和设备，但图标仍为空白。

我还注意到，在资产目录中的文件夹之间拖动图像有时会导致有关“未分配的项目”的警告，但我不确定这是否相关。

非常感谢任何帮助！

Answer 1

出现此问题的原因是，当您添加 tvOS 应用程序图标时，Xcode 要求您在项目的“构建设置”中显式配置“应用程序图标集名称”。在资产目录中的文件夹之间拖动图像还可能导致内部问题和有关“未分配项目”的警告，这可能会破坏资产分配过程。 解决方法如下：

解决空白应用程序图标问题的步骤：

清理所有有问题的文件夹：
1. 打开您的
   Assets.xcassets
   • 目录。如果您之前添加了“品牌资产”文件夹或创建了其他文件夹，请将其删除以重新开始。
添加新的 tvOS 应用程序图标：
2. 确保资产目录中没有选择任何文件夹。
   • 单击底部的 + 按钮并选择：
   App Icons & Launch Images > New tvOS App Icon and Top Shelf Image.
   • 这将创建一个名为 Brand Assets 的新文件夹，其中包含两个分层图像：“应用程序图标 - 应用程序商店”和“应用程序图标”。
重命名文件夹
3. （可选但推荐）： 将“Brand Assets”文件夹重命名为有意义的名称，例如“tvOS Assets”（稍后将在“构建设置”中引用。）
添加您的应用程序图标图像
4. ： 将大和小应用程序图标 PNG 文件拖到各自的图层中。
   • 避免在文件夹之间拖动图像，因为这可能会破坏内部引用。
更新构建设置
5. ： 转到项目的
   Build Settings
   • 选项卡。 向下滚动到
   资产目录编译器
   • - 选项部分（靠近底部）。 在
   Primary App Icon Set Name
   • 下，您会发现

     Debug

     和

     Release

     ，两者都将设置为“App Icon”（或可能为“AppIcon”）。 您想要做的是在“调试”和“发布”下方添加一个新行，并将键设置为“任何 tvOS 或 tvOS Simulator SDK”

构建和部署

：
6. 清理项目（Cmd + Shift + K）并重建它。
   将应用程序部署到 Apple TV 模拟器或设备。
   验证图标
：
7. 如果图标仍未出现，请尝试从 Apple TV 中删除该应用程序并重新部署。