Widget Gallery中Widget排序问题：如何让WidgetBundle默认显示第一个Widget

该现象是iOS系统读取WidgetBundle默认展示项的优先级规则导致，系统会优先匹配用户历史添加过的Widget类型、Info.plist中的配置顺序、以及Widget是否有显式默认配置标记，而非完全遵循WidgetBundle中的代码声明顺序。

1. 为首个Widget添加默认内容标记 #

你所有Widget都使用了动态意图配置，需要给第一个Widget的IntentConfiguration显式添加defaultContent修饰，标记其为系统优先识别的默认展示项：

// Widget1 配置示例
IntentConfiguration(
    kind: "你的Widget1唯一标识ID",
    intent: 你的动态Intent类.self,
    provider: 你的Provider类()
) { entry in
    Widget1EntryView(entry: entry)
}
.supportedFamilies([.systemSmall])
// 新增该行，显式指定为small尺寸的默认展示内容
.defaultContent(for: [.systemSmall])

其余Widget2、Widget3不需要添加该修饰。

2. 对齐Info.plist的Widget排序 #

打开项目的Info.plist，依次展开NSExtension -> NSExtensionAttributes -> WidgetKit -> SupportedWidgetKits，确保数组内元素的顺序和你WidgetBundle中声明的顺序完全一致，且第一个元素为Widget1的唯一标识ID。系统读取默认项时会优先遵循该数组的排序。

3. 开发阶段清除缓存后测试 #

开发调试时出现该问题大概率是系统Widget缓存导致，系统会记住你之前添加过的同应用Widget，优先展示最近使用的类型。测试首次安装的用户行为前按以下步骤操作：

• 完全卸载测试设备上的应用
• 重启测试设备（可选，可彻底清除残留缓存）
• 重新编译安装应用后再打开组件库验证

4. 补充预览上下文配置 #

在Widget1的预览代码中显式指定预览上下文，提升其在组件库的展示优先级：

struct Widget1_Previews: PreviewProvider {
    static var previews: some View {
        Widget1EntryView(entry: 你的Entry模型())
            .previewContext(WidgetPreviewContext(family: .systemSmall))
            .previewDisplayName("Widget1的展示名称")
    }
}

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