Xcode 14.2 macOS Widget Extension预览功能不支持问题求助

问题原因 #

你遇到的UnsupportedMacAppExtensionTypeError是Xcode 14.x版本的已知限制——该版本确实不支持macOS Widget Extension的预览功能，无论是否修改模板默认配置都会触发这个错误，和你的实现无关。

可行解决方案 #

• 升级到Xcode 15及以上版本：苹果在Xcode 15中修复了macOS Widget预览的支持问题，升级后即可正常使用预览功能。
• 临时测试方案：
  • 直接运行主应用，打开通知中心添加你的Widget，查看实际运行效果。
  • 新建一个iOS/iPadOS Widget Extension目标，先在iOS预览中调试Widget的UI和逻辑，再将代码同步到macOS目标中。
• 验证沙盒配置：确认Widget Extension的沙盒权限与主应用保持一致（默认模板已配置），避免后续出现其他权限相关问题。

你的环境与错误信息 #

错误日志

UnsupportedMacAppExtensionTypeError: Widget extensions are not supported

Xcode does not support previews in a macOS Widget extension

extension: AppExtension(bundleIdentifier: "com.louisstudio.WidgetHub.ProjectWidget", displayName: "ProjectWidgetExtension", kind: PreviewsPlatforms.AppExtension.Kind.homeScreen, signingInformation: Optional(Code Signing {
  identifier: com.louisstudio.WidgetHub.ProjectWidget
  identity: 04FFDADBA91F279D4A0CC823B283DC1115BF09DB
  hasGetTaskAllow: false
  isSandboxed: true
}))

系统环境

macOS Version: 12.6.2 (21G320)
Xcode Version: 14.2

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