WatchOS应用添加Widget Extension无法预览及嵌入问题求助

检查版本与配置一致性 #

• 确认WatchOS主应用和Complication Extension的Deployment Target版本完全匹配，版本差异会导致关联失败
• 核对主应用Info.plist：确保包含WKCompanionAppBundleIdentifier字段，且值与iPhone主应用的Bundle ID一致；同时检查Complication Extension的Info.plist，确认NSExtension -> NSExtensionAttributes -> WKComplicationPrincipalClass正确指向你的Complication逻辑类

手动配置嵌入关联 #

1. 选中Complication Extension的Target，进入General标签页
2. 在Frameworks, Libraries, and Embedded Content区域，点击+按钮，添加你的WatchOS主应用
3. 切换到WatchOS主应用的Target，进入General标签页，在Embedded App Extensions区域，确认Complication Extension已被添加，未添加则手动补充

清理重建项目 #

• 执行Cmd+Shift+K清理项目，再执行Cmd+Option+Shift+K清理构建文件夹
• 重启Xcode后重新打开项目，尝试构建并预览

验证Bundle ID与签名 #

• 确保主应用和Extension的Bundle ID为层级关系（例如主应用com.xxx.watchapp，Extension为com.xxx.watchapp.complication）
• 确认两者的签名配置（Team、Provisioning Profile）完全一致，且均支持WatchOS扩展

错误提示回顾：
AppExtensionNeedsContainingAppError:
ComplicationExtension.appex must be in an app
The app extension "ComplicationExtension.appex" needs to be embedded in an app in order to use previews

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