iOS应用同时兼容iOS13与iOS14小组件的实现方案咨询

核心结论先给：如果要同时兼容iOS 13和iOS 14的小组件能力，必须同时保留旧版Today Extension、新增WidgetKit实现，两套扩展完全独立，系统会自动根据运行版本做分流，不会产生冲突。

具体适配规则 #

• 系统自动分流逻辑
  两个扩展的运行边界完全由系统控制，不需要手动写全局版本判断切换：
  • 设备运行iOS 13及更早版本时，系统只会识别通过NCWidgetProviding实现的旧版Today Extension，完全不会加载WidgetKit相关内容，旧版小组件的展示、交互逻辑和原有实现完全一致，不会受新增Widget Extension的影响。
  • 设备运行iOS 14及以上版本时，系统会优先在桌面小组件库展示用WidgetKit实现的新版小组件，旧版Today Extension会自动被归到通知中心「今天」视图的最底部折叠区，不会出现在桌面小组件列表里，对用户的干扰极小。
• 实现避坑点
  • 不要删除原有的Today Extension target，直接在项目中新增Widget Extension target开发新版小组件即可。两个扩展可以通过App Group、共享Framework的方式复用同一套业务数据源，不用重复写数据拉取、加工逻辑。
  • Widget Extension的最低部署版本必须设置为iOS 14.0，旧Today Extension的最低部署版本保持原有配置（iOS 13或更早）即可，Xcode不会报版本冲突。
  • 如果你不希望iOS 14+用户在通知中心折叠区看到旧版Today Extension，不需要删除旧target，只需要在旧版扩展的生命周期方法里判断系统版本，iOS 14及以上直接隐藏扩展视图即可，也可以通过在旧扩展的Info.plist中配置NCWidgetVisibility参数实现默认隐藏。

苹果虽然没有单独发布双版本共存的专项适配指南，但在WidgetKit的API说明中明确标注：WidgetKit仅支持iOS 14及以上系统，旧版Today Extension在iOS 14+系统中不会被强制废弃下架，二者共存是官方允许的适配方案，也是目前主流应用覆盖新旧系统版本时的通用做法。

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