如何在「添加Widget」列表中添加Widget快照？

我已创建锁屏Widget，在「添加Widget」列表中能看到我的应用，但Widget无法以快照/图片形式显示（如下图红框标记位置），相关实现代码如下，恳请提供技术帮助。

实现代码 #

struct ToDoLockScreenWidget: Widget {
let kind: String = "Lock Screen Widget"
var body: some WidgetConfiguration {
    if #available(iOSApplicationExtension 16.0, *) {
        return StaticConfiguration(kind: kind, provider: Provider()) { entry in
            ToDoLockScreenWidgetView(entry: entry)
                .widgetURL(URL(string: WidgetURL.lockScreenWidget))
        }
        .supportedFamilies([.accessoryCircular])
        
    } else {
        // Fallback on earlier versions
        return EmptyWidgetConfiguration()
    }
}

可能的解决方向 #

• 完善Provider的占位数据：系统依赖TimelineProvider的placeholder(in:)方法生成预览快照，必须返回能渲染出有效UI的示例数据，不能返回空内容。比如给Entry填充默认的待办文本、图标等：

  struct Provider: TimelineProvider {
      func placeholder(in context: Context) -> YourEntryType {
          // 替换成你的Entry类型，填充真实示例值
          YourEntryType(date: Date(), todoContent: "示例待办", status: .pending)
      }
      
      // 实现其他必要方法...
  }
  

• 适配圆形Widget布局：.accessoryCircular类型的Widget布局有严格限制，检查ToDoLockScreenWidgetView是否在数据为空时也有基础显示内容（比如默认图标、提示文本），避免因内容为空导致预览不生成。
• 重置系统缓存：删除App重新安装，或者重启设备，强制系统重新生成Widget的预览快照。
• 校验Extension配置：确认WidgetExtension的Info.plist中，NSExtension -> NSExtensionAttributes -> widgetFamily已正确设置为accessoryCircular，且扩展Bundle ID与主App关联正常。

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