Xcode14开发组件在iOS15及更早版本不显示问题求助

1. 调整WidgetKit的链接方式 #

把WidgetExtension的WidgetKit框架设置为弱链接，因为iOS 15的WidgetKit不包含accessoryCorner这类iOS 16新增的枚举值，强链接会导致启动阶段直接找不到符号崩溃。

• 操作路径：打开项目的WidgetExtension Target → 进入Build Settings → 搜索Other Linker Flags，添加-weak_framework WidgetKit
• 或者在Frameworks, Libraries, and Embedded Content面板中，将WidgetKit的Embed选项改为Do Not Embed，确认Link类型为Weak

2. 彻底清理编译缓存 #

Xcode的缓存可能残留了旧的符号引用，执行以下操作：

• 关闭Xcode，删除~/Library/Developer/Xcode/DerivedData目录下的全部内容
• 用快捷键Cmd+Shift+K清理项目，再用Cmd+Option+Shift+K做深度清理
• 重启模拟器，删除模拟器上的App和WidgetExtension组件，重新编译运行

3. 排查隐式的iOS 16符号引用 #

即使删除了显式的accessoryCorner代码，仍可能存在隐式引用：

• 检查WidgetFamily的switch语句，确保所有iOS 16专属的枚举值都用@available(iOS 16.0, *)包裹
• 排查SwiftUI视图中是否引用了iOS 16专属的Widget修饰符，比如相关的锁屏组件布局配置
• 示例正确的版本兼容写法：

@main
struct MyAppWidgetExtension: Widget {
    let kind: String = "MyAppWidgetExtension"

    var body: some WidgetConfiguration {
        StaticConfiguration(kind: kind, provider: Provider()) { entry in
            MyAppWidgetEntryView(entry: entry)
        }
        .configurationDisplayName("My Widget")
        .description("This is an example widget.")
        .supportedFamilies(supportedFamilies)
    }
    
    private var supportedFamilies: [WidgetFamily] {
        var baseFamilies: [WidgetFamily] = [.systemSmall, .systemMedium, .systemLarge]
        if #available(iOS 16.0, *) {
            baseFamilies.append(contentsOf: [.accessoryCorner, .accessoryCircular, .accessoryInline])
        }
        return baseFamilies
    }
}

4. 检查TestFlight构建的配置 #

确保上传TestFlight的构建满足兼容要求：

• 确认WidgetExtension的Deployment Target设置为iOS 15.0及以上
• 检查Build Settings中的Base SDK设置为最新iOS SDK，但部署目标保持兼容iOS 15

5. 重建WidgetExtension（极端方案） #

如果以上操作都无效，可能是WidgetExtension的项目文件损坏：

• 删除当前的WidgetExtension Target
• 重新创建一个新的WidgetExtension Target，配置好兼容iOS 15的基础设置后，再逐步迁移原有代码

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