如何将含Widget的多Target应用发布至App Store？

一、本地Target配置检查 #

• 确保Widget Target的Bundle ID遵循主App的嵌套格式：比如主App Bundle ID为com.yourdomain.mainapp，Widget必须设为com.yourdomain.mainapp.widget，不能使用独立的Bundle ID
• 主App Target的General标签下，在Frameworks, Libraries, and Embedded Content中，将Widget Target的产物设置为Embed & Sign；同时确认Embedded Binaries里已包含Widget（Xcode 11+可能合并到前者，但需确保状态正确）
• 核对Widget的Deployment Info：最低系统版本不能高于主App的最低支持版本，否则会被构建忽略

二、App Store Connect关联配置 #

• 登录App Store Connect进入对应App页面，在App Information的App Clips and Widgets板块，确认Widget的Bundle ID已被关联到当前App；若未显示，点击+手动添加对应Widget的Bundle ID
• 上传构建后，进入TestFlight的构建详情页，检查Includes Extensions是否列出了Widget信息；若未显示，说明打包时未正确包含Widget，需重新打包上传

三、打包与上传环节注意事项 #

• Xcode打包归档后，选择Distribute App→App Store Connect，确保在流程中勾选Include bitcode（若项目启用bitcode）
• 上传完成后，在App Store Connect的Activity标签查看构建处理状态，若有报错，前往Resolution Center查看具体提示（常见问题为签名不匹配、Bundle ID未注册）
• 提交审核时，若Widget涉及特殊权限（如定位、健康数据），需在App Review Information中补充说明相关功能用途，避免审核被拒

四、关键排查点 #

• 检查Widget的Info.plist：确认NSExtension下的NSExtensionPointIdentifier值为com.apple.widgetkit-extension，配置错误会导致Widget无法被系统识别
• 统一签名配置：主App和Widget必须使用同一开发者账号的签名证书，且Provisioning Profile包含各自的Bundle ID
• 验证Widget逻辑：若为配置型Widget，检查WidgetConfiguration的实现是否存在逻辑错误，导致Widget加载失败

内容的提问来源于stack exchange，提问作者Jon Magnar Nesvik