含WidgetKit组件的Flutter iOS项目上传TestFlight后不显示，需哪些特殊步骤？

一、检查Widget扩展的基础配置 #

• 确认Widget扩展的Info.plist配置正确：必须包含NSExtension字典，其中NSExtensionPointIdentifier的值为com.apple.widgetkit-extension；同时NSExtensionAttributes下的WKWidgetFamily要列出你支持的所有Widget尺寸（如systemSmall、systemMedium、systemLarge）。
• 验证Widget的Bundle ID：需与主App的Bundle ID关联（比如主ID为com.yourcompany.app，Widget ID设为com.yourcompany.app.widget），且该ID已在Apple开发者后台完成注册，状态正常。

二、确认打包与上传流程包含Widget扩展 #

• 检查Xcode项目的嵌入配置：进入主App的Target设置，在General标签的Frameworks, Libraries, and Embedded Content中，确认Widget扩展已被添加，且嵌入方式设置为Embed & Sign。
• 验证上传的构建是否包含扩展：登录App Store Connect，找到对应的构建版本，查看Build Information下的Included Extensions列表，确认Widget扩展在其中。如果没有，说明归档时未包含扩展，需重新检查Xcode的打包配置后重新归档上传。

三、TestFlight端的显示逻辑与同步问题 #

• Widget不会在TestFlight的App列表中直接展示：用户安装主App后，需长按主App图标进入编辑模式，点击左上角的+号才能找到并添加Widget。
• 等待构建同步：上传成功后，TestFlight的构建信息可能需要10-15分钟完成同步，若刚上传完就安装，可能因缓存导致Widget未显示，可等待一段时间后重新安装尝试。

四、Flutter项目的特殊注意事项 #

• 避免命令行打包遗漏扩展：如果使用flutter build ipa命令打包，可能会忽略Widget扩展目标，建议直接通过Xcode的归档流程（Product > Archive）完成打包上传，确保扩展被正确包含。
• 确认Widget代码无编译异常：Widget的TimelineProvider或IntentTimelineProvider实现必须无错误，若存在编译问题，扩展会被排除在归档之外，需先修复代码错误再重新打包。

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