iOS与watchOS应用及Widget间WatchConnectivity数据共享问题排查

问题概述 #

使用WatchConnectivity从iOS应用向watchOS应用及Widget传输数据，watchOS应用可正常接收，但Widget始终无法获取数据。推测问题与Widget后台状态有关，尝试WKWatchConnectivityRefreshBackgroundTask未成功实现。

涉及代码模块 #

• iOS端发送数据的ContentView代码
• watchOS应用的ContentView代码
• Widget扩展getTimeline关键函数代码
• 跨三方（iOS/watchOS/Widget）共享的Shared类代码（已勾选所有目标成员资格）

核心解决方案 #

Widget作为watchOS扩展，无法像主应用那样持续监听WatchConnectivity事件，必须通过WKWatchConnectivityRefreshBackgroundTask触发后台刷新，结合Widget时间线更新来同步数据。

1. 配置Widget扩展的WatchConnectivity与后台任务处理 #

在Widget的ExtensionDelegate中初始化WCSession并处理后台任务：

import WatchKit
import WatchConnectivity
import WidgetKit

class ExtensionDelegate: NSObject, WKExtensionDelegate, WCSessionDelegate {
    func applicationDidFinishLaunching() {
        guard WCSession.isSupported() else { return }
        let session = WCSession.default
        session.delegate = self
        session.activate()
    }
    
    func handle(_ backgroundTasks: Set<WKRefreshBackgroundTask>) {
        for task in backgroundTasks {
            guard let connectivityTask = task as? WKWatchConnectivityRefreshBackgroundTask else {
                task.setTaskCompletedWithSnapshot(false)
                continue
            }
            
            // 触发数据同步并刷新Widget时间线
            DispatchQueue.main.async {
                WidgetCenter.shared.reloadAllTimelines()
                connectivityTask.setTaskCompletedWithSnapshot(false)
            }
        }
    }
    
    // 接收iOS端发送的ApplicationContext数据
    func session(_ session: WCSession, didReceiveApplicationContext applicationContext: [String : Any]) {
        // 更新Shared类中的共享数据
        Shared.shared.syncData(from: applicationContext)
    }
}

2. 调整Widget TimelineProvider的getTimeline函数 #

确保时间线生成时读取最新的共享数据：

func getTimeline(in context: Context, completion: @escaping (Timeline<Entry>) -> Void) {
    // 从Shared类获取最新数据
    let latestData = Shared.shared.currentData
    let entry = SimpleEntry(date: Date(), displayData: latestData)
    
    // 设置时间线刷新策略，确保数据更新时能及时展示
    let timeline = Timeline(entries: [entry], policy: .after(Date().addingTimeInterval(60)))
    completion(timeline)
}

3. iOS端发送数据优化 #

优先使用updateApplicationContext(_:)方法发送数据，该方法会自动触发Widget的后台刷新任务：

// iOS端发送数据代码示例
func sendDataToWatch() {
    guard WCSession.default.isReachable else { return }
    let data = ["key": "value"]
    do {
        try WCSession.default.updateApplicationContext(data)
    } catch {
        print("发送失败：\(error.localizedDescription)")
    }
}

关键注意事项 #

• 确保Shared类在Widget目标中正确初始化，且数据存储方式（如UserDefaults、App Groups）支持跨扩展访问。
• Widget的Info.plist需正确配置扩展属性，确保后台任务权限生效。
• 避免使用sendMessage系列方法给Widget发数据，这类方法仅适用于双方前台在线场景。

内容的提问来源于stack exchange，提问作者Mr. 0xCa7