iOS设备上Flutter+SwiftUI锁屏Widget在组件列表中缺失求助

• 确认Widget扩展与主应用的部署目标一致
  检查Widget扩展目标的Deployment Target是否和Flutter主应用的iOS部署目标完全匹配。锁屏Widget要求iOS 16及以上版本，若真机系统版本低于该要求，组件会直接隐藏；同时要确保扩展和主应用的版本范围对齐，避免TestFlight分发时出现兼容性过滤。

• 验证Widget扩展的Info.plist配置
  确保扩展的Info.plist里的关键配置无遗漏或错误：

  • NSExtension字典下的NSExtensionAttributes需包含ISLockScreenWidget并设为YES（iOS 16+锁屏组件必填）；
  • NSExtensionPointIdentifier必须设置为com.apple.widgetkit-extension，不能拼写错误；
  • widgetConfiguration的supportedFamilies要包含锁屏专用组件家族：accessoryCircular、accessoryRectangular、accessoryInline，仅添加桌面组件的家族会导致锁屏列表不显示。

• 检查主应用与Widget扩展的签名一致性
  确保主应用和Widget扩展使用相同的团队签名，且两者的Provisioning Profile配置一致。在Xcode的Signing & Capabilities面板中，确认两者的Team选择完全相同，签名不匹配会导致系统拒绝加载扩展组件。

• 清理缓存后重新构建归档
  旧缓存可能导致分发异常，尝试以下操作：

  • 删除Xcode的Derived Data（路径：Xcode > Settings > Locations > Derived Data）；
  • 执行Cmd+Shift+K彻底清理项目后重新构建；
  • 归档完成后，在归档详情中确认Widget扩展已被包含在分发包内。

• 排查Widget的TimelineProvider实现
  模拟器对部分错误的容忍度更高，真机的WidgetKit会严格校验组件逻辑：确保TimelineProvider的getSnapshot和getTimeline方法能正常返回非空的WidgetEntry，无异常抛出或逻辑阻塞，避免因加载失败被系统隐藏。

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