iOS 16、Xcode 14中Widget背景图片无法显示问题求助

问题说明 #

升级Xcode14后测试Widget时，背景图片未正常加载，显示为灰色方块。涉及代码片段：

Image("LargeBackgroundImage")
                .resizable()
                .clipped()
                .scaledToFill()
                .overlay(Color.black.opacity(0.55))
                .accessibilityHidden(true)

实际效果：

可行解决方案 #

• 确认图片资源归属：选中LargeBackgroundImage文件，在Xcode右侧检查器的「Target Membership」中，确保勾选了对应的Widget Extension目标，避免资源未被打包进Widget独立bundle。
• 显式指定资源Bundle：Widget作为独立扩展，默认无法直接访问主App资源，需明确指定bundle：

  Image("LargeBackgroundImage", bundle: Bundle(for: YourWidgetProvider.self))
      .resizable()
      .clipped()
      .scaledToFill()
      .overlay(Color.black.opacity(0.55))
      .accessibilityHidden(true)
  

  替换YourWidgetProvider为你项目中Widget的Provider类名。
• 检查图片适配性：确认图片格式（PNG/JPG等）支持iOS16，且尺寸符合对应Widget类型的官方推荐规格，避免因尺寸不兼容导致加载失败。
• 清理缓存重建项目：执行Cmd+Shift+K清理Build Folder，重启模拟器后重新运行项目，解决Xcode14可能存在的缓存异常问题。

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