iOS17交互式Widget按钮状态切换问题：真机环境失效排查与修复

需求与问题描述 #

需求：在iOS17交互式Widget中，点击按钮后将其设置为加载状态，1秒后恢复为正常状态。

用户实现代码：

func perform() async throws -> some IntentResult {

    if let index = TaskDataModel.shared.task.firstIndex(where: {

        $0.id == sceneId

    }) {

        print(" toggle run")

        TaskDataModel.shared.task[index].isCompleted.toggle()

        DispatchQueue.main.asyncAfter(deadline: .now() + 1) {

            TaskDataModel.shared.task[index].isCompleted.toggle()

//                WidgetCenter.shared.reloadTimelines(ofKind: "WidgetExtension")

            WidgetCenter.shared.reloadAllTimelines()

        }

    }
    return .result()
}

问题：该代码在调试环境运行正常，但真机环境下失效。

问题原因分析 #

1. 异步生命周期不匹配：perform()是异步Intent处理方法，使用DispatchQueue.main.asyncAfter的延迟闭包会在perform()返回.result()后执行。真机上的后台调度限制可能会终止已完成Intent的后续闭包执行，导致状态恢复和Widget刷新操作失效。
2. 线程安全隐患：直接在异步方法中修改共享数据模型TaskDataModel.shared，未确保操作在主线程执行，真机上的多线程环境可能导致数据更新未同步到Widget。
3. 刷新时机错误：reloadAllTimelines()放在延迟闭包中，此时Intent的处理流程已结束，Widget可能无法正确接收刷新信号。

修复方案与代码 #

核心修复点 #

• 使用Swift Concurrency的async/await替代DispatchQueue延迟操作，确保perform()等待所有操作完成后再返回。
• 用@MainActor标记方法，保证所有UI相关的数据修改和Widget刷新操作在主线程执行。
• 优化Widget刷新方式，只刷新目标Widget而非全部，提升性能和可靠性。

修复后的代码 #

@MainActor
func perform() async throws -> some IntentResult {
    guard let index = TaskDataModel.shared.task.firstIndex(where: { $0.id == sceneId }) else {
        return .result()
    }
    
    print("toggle run")
    // 切换为加载状态
    TaskDataModel.shared.task[index].isCompleted.toggle()
    
    // 等待1秒（Swift Concurrency风格的延迟）
    try await Task.sleep(nanoseconds: 1_000_000_000)
    
    // 恢复为正常状态
    TaskDataModel.shared.task[index].isCompleted.toggle()
    
    // 刷新指定Widget的时间线，比reloadAll更高效可靠
    try await WidgetCenter.shared.reloadTimelines(ofKind: "WidgetExtension")
    
    return .result()
}

额外注意事项 #

• 确保TaskDataModel是线程安全的：如果是ObservableObject，建议用@Published修饰task数组；如果是自定义数据模型，需添加线程锁（如NSLock）避免多线程冲突。
• 真机测试时，确保Widget的Intent配置正确，且App Groups已配置（如果Widget和主App共享数据）。

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