如何在iOS ViewController与Widget小组件之间共享并访问Core Data

1. 前置校验项 #

• 确保主App和Widget的Target已开启相同的App Group权限，替换为你自己的Group ID（即代码中的<myGroupID>，格式一般为group.com.xxx.xxx）
• 确保Core Data模型文件（.xcdatamodeld）的Target Membership同时勾选主App和Widget，两端模型内容、版本完全一致

2. 主App端Core Data配置修正 #

你当前代码的核心问题1：默认Core Data存储在主App私有沙盒内，Widget无访问权限，需修改AppDelegate中持久化容器的存储路径为App Group共享目录：

// AppDelegate.swift
lazy var persistentContainer: NSPersistentContainer = {
    // 此处填写你的.xcdatamodeld文件名，不是实体名！
    let container = NSPersistentContainer(name: "DataModel")
    // 替换为你自己的App Group ID
    let groupID = "group.com.yourapp.xxx"
    let containerURL = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: groupID)!
    let storeURL = containerURL.appendingPathComponent("DataModel.sqlite")
    let description = NSPersistentStoreDescription(url: storeURL)
    
    // 可选配置：开启自动迁移，避免模型版本升级时崩溃
    description.setOption(true as NSNumber, forKey: NSMigratePersistentStoresAutomaticallyOption)
    description.setOption(true as NSNumber, forKey: NSInferMappingModelAutomaticallyOption)
    container.persistentStoreDescriptions = [description]
    
    container.loadPersistentStores(completionHandler: { (storeDescription, error) in
        if let error = error as NSError? {
            fatalError("Core Data加载失败: \(error), \(error.userInfo)")
        }
    })
    return container
}()

修改后你原有的ViewController存储代码无需调整，存储的数据会自动写入共享目录。

3. Widget端读取代码修正 #

你当前代码的核心问题2：重复初始化持久化容器后，未使用该容器的上下文查询，反而调用了独立的CoreDataStack.shared导致上下文数据不连通，修正后代码如下：

// Widget.swift
func getTimeline(for configuration: ConfigurationIntent, in context: Context, completion: @escaping (Timeline<Entry>) -> ()) {
    var entries: [SimpleEntry] = []
    let currentDate = Date()
    
    // 和主App保持一致的Group ID
    let groupID = "group.com.yourapp.xxx"
    let containerURL = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: groupID)!
    let storeURL = containerURL.appendingPathComponent("DataModel.sqlite")
    let description = NSPersistentStoreDescription(url: storeURL)
    //  Widget仅读数据的话开启只读模式，性能更高
    description.isReadOnly = true
    
    // 和主App保持一致的.xcdatamodeld文件名
    let container = NSPersistentContainer(name: "DataModel")
    container.persistentStoreDescriptions = [description]
    container.loadPersistentStores { description, error in
        if let error = error {
            print("Core Data加载失败: \(error)")
            // 不要用fatalError，会导致Widget直接崩溃
            let entry = SimpleEntry(date: currentDate, showText: "无数据")
            entries.append(entry)
            completion(Timeline(entries: entries, policy: .atEnd))
            return
        }
        
        // 使用当前容器的上下文查询数据
        let moc = container.viewContext
        let request = NSFetchRequest<NSFetchRequestResult>(entityName: "Entity")
        // 按需添加查询条件
        // request.predicate = NSPredicate(format: "attribute1 == %@", "test")
        do {
            let result = try moc.fetch(request) as? [NSManagedObject] ?? []
            let showText = result.first?.value(forKey: "name") as? String ?? "无存储数据"
            entries.append(SimpleEntry(date: currentDate, showText: showText))
        } catch {
            print("数据查询失败: \(error)")
            entries.append(SimpleEntry(date: currentDate, showText: "读取失败"))
        }
        completion(Timeline(entries: entries, policy: .atEnd))
    }
}

4. 注意事项 #

• Widget内存限制极低，不要批量查询大量Core Data数据，按需做条件查询
• 若需要在Widget端写入数据，去掉description.isReadOnly = true配置即可，非必要不推荐Widget侧写数据
• 模型版本更新时需要主App和Widget同步更新，否则会出现存储加载失败问题

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