Apple Watch Complication无法使用资源图片的问题求助

以下是针对watchOS 9 SwiftUI Complication无法加载资源图片的排查和解决步骤：

• 检查Asset的目标成员配置
  打开Widget Extension的Asset Catalog，选中你的图片，在Xcode右侧检查器的「Target Membership」区域，确保勾选了你的Widget Extension目标（不要只勾选主App目标）。Complication属于Widget Extension范畴，必须让图片资源归属到这个target下才能被访问。

• 验证图片命名与尺寸规范

  • 确保Image("image_name")中的名称和Asset里的图片名称完全一致（区分大小写，避免空格、特殊字符，建议用小写+下划线的命名方式）。
  • 按照watchOS Complication的尺寸要求准备图片：不同样式的Complication对图片大小有严格限制，比如圆形Complication建议使用小尺寸图标，你可以设置图片为「Single Scale」，或者提供符合@2x/@3x比例的图片版本，避免因尺寸不匹配导致渲染失败。

• 显式指定Bundle加载图片
  由于Complication运行在Widget Extension的独立bundle中，有时默认bundle会指向主App，导致图片找不到。可以显式指定Widget Extension的bundle：

  // 假设你的Widget Extension中有Provider类，用它来获取对应bundle
  Image("image_name", bundle: Bundle(for: Provider.self))
  

• 清理缓存并重建项目

  • 执行Command+Shift+K清理Xcode构建文件夹。
  • 执行Command+Option+Shift+K清理派生数据。
  • 重启Xcode，重新连接模拟器或真机，重新运行项目，避免缓存导致的资源加载异常。

• 单独测试Widget环境中的图片加载
  在Widget Extension的预览代码中单独添加图片测试，确认图片能在Widget环境正常显示后，再集成到Complication的View中，排除Complication逻辑本身的问题（比如条件渲染隐藏了图片）。

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