iOS 14生产环境应用更新后新增Widget在小组件容器中找不到

这是静态Widget迭代开发中的高频共性问题，大量已上线应用的开发者都遇到过同类场景，核心触发原因和排查方向如下：

• 系统Widget注册表未主动刷新
  系统对静态Widget的扫描注册逻辑，默认仅在应用首次安装、首次冷启动时触发。针对已安装旧版本的存量用户，应用完成升级后，系统不会主动重新扫描Widget Extension中的新增条目，哪怕所有配置完全正确，新Widget也不会出现在容器的可选列表中。
  解决方式：在主应用冷启动流程完成后，主动调用系统Widget刷新接口，显式触发系统重新扫描全量Widget注册表，参考调用逻辑：
  WidgetCenter.shared.reloadAllTimelines()
• 新增Widget的标识配置错配
  逐一核对新增Widget的kind全局标识：首先要保证和同应用下原有5个静态Widget的标识无重复，其次要和Widget Extension target的Info.plist中声明的扩展参数完全对齐，哪怕单字符的拼写偏差，都会导致系统识别失败，直接将新Widget从可选列表中过滤掉。
• Widget代码未纳入Extension编译范围
  如果新增Widget的逻辑代码仅绑定了主应用的编译target，没有加入Widget Extension的Build Phases编译清单，最终打包产出的Extension二进制文件中，根本不包含新Widget的实现逻辑。Widget容器扫描Extension时，识别到的仍是旧版的5个Widget定义，自然无法找到新增条目。
• 本地旧配置缓存干扰
  部分用户端会将首次安装时获取的Widget列表缓存到本地配置文件，应用升级后直接读取旧缓存而不主动更新。这种情况可以在应用识别到版本升级的首次启动时，清理对应的本地旧缓存条目，强制系统重新拉取全量Widget列表。

如果排查时发现全新安装的用户可以看到全部6个Widget，仅从旧版本升级的存量用户看不到新增Widget，基本可以确定是注册表未主动刷新导致的，而非代码逻辑错误。

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