Widget配置更新异常：IntentHandler未同步更新问题求助

问题描述 #

我有一个带动态选项的可配置Widget，用户可选择“Widget1”或“Widget2”等选项（配图：）。数据由UserDefaults提供，可在主APP中修改。

当在主APP中修改“Widget1”的文本并调用WidgetCenter.shared.reloadAllTimelines()更新Widget时，出现以下异常：

• Widget视图未同步更新
• 选中的“Widget1”选项被取消，需重新选择该选项才会显示正确数据

问题步骤截图：

1. 选中选项状态：
2. 修改数据并刷新后无变化：
3. 选中的“Widget1”选项丢失：
4. 重新选择后显示正确数据：

现有IntentHandler代码 #

class IntentHandler: INExtension, ChooseWidgetIntentHandling {
    
    func provideStylingOptionsCollection(for intent: ChooseWidgetIntent, with completion: @escaping (INObjectCollection<Styling>?, Error?) -> Void) {
        
        let stylingConfiguration: [Styling] = Widget.array.map { widget in
            let styling = Styling(identifier: widget.name, display: widget.name)
            styling.text = widget.text
            styling.category = widget.category as? NSNumber
            
            return styling
        }
        
        let collection = INObjectCollection(items: stylingConfiguration)
        
        completion(collection, nil)
    }
}

解决方案 #

1. 确保主APP与Widget共享UserDefaults #

主APP和WidgetExtension必须开启App Groups，使用同一个共享容器存取数据，否则Widget无法获取主APP修改后的最新数据：

• 在Xcode中，分别为APP和Widget的Target添加相同的App Group
• 通过UserDefaults(suiteName: "你的AppGroupID")替代默认的UserDefaults.standard进行数据读写

2. 修改IntentHandler保留用户选中状态 #

当前provideStylingOptionsCollection每次重建选项时未关联用户已选中的配置，导致选中状态丢失。修改代码保留选中状态：

class IntentHandler: INExtension, ChooseWidgetIntentHandling {
    
    func provideStylingOptionsCollection(for intent: ChooseWidgetIntent, with completion: @escaping (INObjectCollection<Styling>?, Error?) -> Void) {
        // 从共享UserDefaults读取最新Widget配置
        let sharedDefaults = UserDefaults(suiteName: "你的AppGroupID")
        // 替换为从共享容器中获取最新配置的逻辑
        let widgetArray = // 此处实现读取最新Widget数组的代码
        
        let stylingConfiguration: [Styling] = widgetArray.map { widget in
            let styling = Styling(identifier: widget.name, display: widget.name)
            styling.text = widget.text
            styling.category = widget.category as? NSNumber
            
            // 匹配用户已选中的选项，保留选中状态
            if let selectedId = intent.styling?.identifier, selectedId == widget.name {
                intent.styling = styling
            }
            
            return styling
        }
        
        let collection = INObjectCollection(items: stylingConfiguration)
        completion(collection, nil)
    }
}

3. 主APP更新数据后同步更新Intent #

仅调用reloadAllTimelines()无法同步Intent配置，需先更新Intent再刷新Timeline：

// 主APP修改数据后执行以下代码
let sharedDefaults = UserDefaults(suiteName: "你的AppGroupID")
// 获取用户之前选中的Widget标识（需提前存在共享容器中）
guard let selectedWidgetName = sharedDefaults?.string(forKey: "SelectedWidgetName") else { return }

// 构建最新的Intent配置
let intent = ChooseWidgetIntent()
let selectedStyling = Styling(identifier: selectedWidgetName, display: selectedWidgetName)
selectedStyling.text = sharedDefaults?.string(forKey: "\(selectedWidgetName)_text")
intent.styling = selectedStyling

// 更新Intent并刷新Timeline
WidgetCenter.shared.updateIntent(for: ChooseWidgetIntent.self) { error in
    if let error = error {
        print("更新Intent失败: \(error)")
    } else {
        WidgetCenter.shared.reloadAllTimelines()
    }
}

4. Widget视图依赖Intent数据渲染 #

确保Widget的TimelineProvider从Intent中获取最新数据，保证渲染与选中状态一致：

struct WidgetProvider: IntentTimelineProvider {
    func getTimeline(for configuration: ChooseWidgetIntent, in context: Context, completion: @escaping (Timeline<Entry>) -> Void) {
        // 从Intent中读取选中Widget的最新数据
        let entryText = configuration.styling?.text ?? "默认文本"
        let entry = SimpleEntry(date: Date(), text: entryText)
        
        let timeline = Timeline(entries: [entry], policy: .never)
        completion(timeline)
    }
    
    // 实现其他协议方法（placeholder、getSnapshot）
}

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