Core Data预置默认值实现：如何将预生成Core Data文件内置到应用供所有用户使用

第一步：导出预填充完成的Core Data文件 #

使用模拟器运行已经完成数据预置的应用，找到对应模拟器沙盒内的Core Data存储文件：通常主存储文件为.sqlite后缀，同时会附带.sqlite-wal（预写日志）和.sqlite-shm（共享内存文件）两个附属文件，三个文件需要全部导出。

导出前请确保所有预置数据已经执行Core Data的save操作完成持久化，建议生成完数据后手动触发一次save、杀掉应用进程后再导出文件，避免预写日志中存在未写入主文件的缓存数据。

第二步：将导出文件添加到Xcode项目 #

将导出的三个文件直接拖拽进Xcode项目目录中，弹出的配置窗口务必勾选 Copy items if needed，同时在Target Membership列表中勾选你要打包的应用目标，保证打包时文件会被内置到应用的main bundle中。

第三步：修改Core Data初始化逻辑，首次启动拷贝内置文件到可写目录 #

应用包内的所有文件都是只读权限，无法直接作为Core Data的运行存储目录，因此需要在应用首次启动时，将bundle内的预置文件拷贝到沙盒的Application Support或Documents目录下，后续Core Data直接访问沙盒内的可写文件即可。
核心逻辑示例代码如下：

func copyPrepopulatedCoreDataIfNeeded() {
    let fileManager = FileManager.default
    // 定义沙盒内Core Data存储的目标路径
    guard let supportDir = fileManager.urls(for: .applicationSupportDirectory, in: .userDomainMask).first else { return }
    let targetStoreUrl = supportDir.appendingPathComponent("MyAppCoreData.sqlite")
    
    // 沙盒内已存在存储文件则跳过拷贝，避免覆盖用户数据
    guard !fileManager.fileExists(atPath: targetStoreUrl.path) else { return }
    
    // 获取应用包内预置的Core Data文件路径，这里假设你导入的预置文件名为preload.sqlite
    guard let sourceStoreUrl = Bundle.main.url(forResource: "preload", withExtension: "sqlite") else { return }
    let sourceWalUrl = sourceStoreUrl.deletingPathExtension().appendingPathExtension("sqlite-wal")
    let sourceShmUrl = sourceStoreUrl.deletingPathExtension().appendingPathExtension("sqlite-shm")
    
    // 对应生成沙盒内的附属文件路径
    let targetWalUrl = targetStoreUrl.deletingPathExtension().appendingPathExtension("sqlite-wal")
    let targetShmUrl = targetStoreUrl.deletingPathExtension().appendingPathExtension("sqlite-shm")
    
    do {
        // 拷贝全部三个文件到沙盒
        try fileManager.copyItem(at: sourceStoreUrl, to: targetStoreUrl)
        try fileManager.copyItem(at: sourceWalUrl, to: targetWalUrl)
        try fileManager.copyItem(at: sourceShmUrl, to: targetShmUrl)
    } catch {
        print("预置Core Data文件拷贝失败：\(error.localizedDescription)")
    }
}

调用该方法的时机为初始化Core Data堆栈（如NSPersistentContainer）之前，同时注意初始化NSPersistentContainer时需要通过NSPersistentStoreDescription指定存储路径为上述代码中的targetStoreUrl，和拷贝目标路径保持一致即可。

注意事项 #

• 后续如果更新了内置的预置数据，需要新增版本判断逻辑，避免覆盖用户安装应用后生成的新数据，仅针对新安装用户执行新预置文件的拷贝。
• 导出的预置Core Data文件的模型版本必须和当前应用内置的Core Data模型版本完全一致，否则会出现版本不匹配的加载错误。
• 如果不需要WAL日志模式，可以在导出预置文件前临时关闭WAL，仅需拷贝单个.sqlite文件即可，减少文件处理的复杂度。

内容的提问来源于stack exchange，提问作者Алексей Фирсов