第 7 章：多个 ModelContainer 与配置

将数据存储到指定路径

默认存储路径与自定义需求

默认情况下，SwiftData 会将数据存储在应用的沙盒目录中（通常是 Library/Application Support/ 目录）。但在某些场景下，开发者可能需要：

  1. 将数据存储到用户指定的目录（如文档目录）
  2. 实现多用户数据隔离
  3. 支持外部存储设备（如U盘）的数据读写

配置自定义存储路径

通过 ModelConfiguration 可以指定存储路径：

import SwiftData
import Foundation

// 获取目标目录URL（示例：文档目录）
let documentsURL = FileManager.default.urls(
    for: .documentDirectory, 
    in: .userDomainMask
).first!

// 创建自定义存储URL
let storeURL = documentsURL.appendingPathComponent("CustomData.store")

// 创建配置
let config = ModelConfiguration(
    url: storeURL,
    cloudKitContainerIdentifier: nil // 不需要云同步时设为nil
)

// 创建ModelContainer时传入配置
let container = try ModelContainer(
    for: YourDataModel.self,
    configurations: config
)

注意事项

  1. 目录权限：

    • 确保应用有目标路径的读写权限
    • 使用 FileManager 检查目录是否存在，必要时创建目录

  2. 路径有效性：

    // 检查路径是否可访问
if !FileManager.default.fileExists(atPath: storeURL.path) {
    try FileManager.default.createDirectory(
        at: storeURL.deletingLastPathComponent(),
        withIntermediateDirectories: true
    )
}

  3. 多容器场景：

    • 可以为不同数据模型配置不同存储路径
    • 示例：用户数据与系统配置分开存储

实际应用场景示例

场景：实现用户自定义数据存储位置

func setupUserContainer(userId: String) throws -> ModelContainer {
    let userDir = getAppSupportDirectory()
        .appendingPathComponent("Users")
        .appendingPathComponent(userId)
    
    try FileManager.default.createDirectory(
        at: userDir,
        withIntermediateDirectories: true
    )
    
    let storeURL = userDir.appendingPathComponent("UserData.store")
    let config = ModelConfiguration(url: storeURL)
    
    return try ModelContainer(
        for: [User.self, Document.self],
        configurations: config
    )
}

private func getAppSupportDirectory() -> URL {
    FileManager.default.urls(
        for: .applicationSupportDirectory,
        in: .userDomainMask
    ).first!
}

迁移现有数据

如果需要将默认存储迁移到自定义路径：

func migrateToCustomLocation() throws {
    let defaultContainer = try ModelContainer(for: Schema([YourModel.self]))
    let defaultStore = defaultContainer.configurations.first?.url
    
    guard let sourceURL = defaultStore else { return }
    
    let destinationURL = // 你的目标路径
    
    // 使用FileManager迁移文件
    if FileManager.default.fileExists(atPath: sourceURL.path) {
        try FileManager.default.moveItem(
            at: sourceURL,
            to: destinationURL
        )
    }
}

故障排除

常见问题及解决方案：

  1. 权限错误：

    • 错误信息："The file couldn’t be opened because you don’t have permission to view it"
    • 解决方案：确保目标路径可写，检查沙盒权限

  2. 路径无效：

    • 错误信息："The specified storage URL is not a file URL"
    • 解决方案：使用 URL(fileURLWithPath:) 构造绝对路径

  3. 多线程访问冲突：

    • 建议：对同一存储文件使用单一 ModelContainer 实例

这个章节内容包含了：
1. 核心配置方法
2. 实际代码示例
3. 常见应用场景
4. 错误处理建议
5. 迁移现有数据的方案

所有内容均围绕「将数据存储到指定路径」这个主题展开，同时保持与SwiftData的技术特性一致。
Last Updated::