如何使用Realm Swift在iOS设备本地存储文本、缩略图等静态资源

首先明确核心存储原则：小体积资源直接存入Realm降低管理成本，大体积资源存沙盒文件系统、Realm仅存储元数据，兼顾查询性能和存储效率。

1. 资源存储边界划分 #

• 小于16MB的资源（短文本、缩略图、小体积3D模型片段）：直接存入Realm的Data类型字段，性能损耗可忽略，无需额外管理文件路径
• 大于16MB的资源（长视频、完整大体积3D文件）：存入App沙盒的Library/Caches或Documents目录，Realm仅存储资源唯一标识、本地路径、资源类型等元数据，避免Realm单文件体积过度膨胀拉低查询效率

2. 定义Realm数据模型 #

import RealmSwift

class StaticAsset: Object {
    // 资源唯一ID，作为主键用于快速查询
    @Persisted(primaryKey: true) var assetId: String = ""
    // 资源类型标记：text/thumbnail/video/3dModel等
    @Persisted var assetType: String = ""
    // 小体积资源直接存储二进制数据，大资源该字段留空
    @Persisted var assetData: Data?
    // 大体积资源的本地存储绝对路径，小资源该字段留空
    @Persisted var localPath: String?
    // 文本类资源直接存储字符串，避免Data转码开销
    @Persisted var textContent: String?
    // 可选：资源版本号，用于后续资源增量更新校验
    @Persisted var version: Int = 1
}

3. 资源写入实现示例 #

写入小体积缩略图 #

func saveThumbnail(assetId: String, image: UIImage) throws {
    let realm = try Realm()
    let asset = StaticAsset()
    asset.assetId = assetId
    asset.assetType = "thumbnail"
    asset.assetData = image.pngData()
    try realm.write {
        // 同assetId的资源已存在则更新，不存在则新增
        realm.add(asset, update: .modified)
    }
}

写入大体积3D模型 #

func save3DModel(assetId: String, sourceUrl: URL) throws {
    // 先将源文件移动到沙盒指定存储目录
    let docsDir = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
    let targetUrl = docsDir.appendingPathComponent("3d_assets/\(assetId).usdz")
    try FileManager.default.createDirectory(at: targetUrl.deletingLastPathComponent(), withIntermediateDirectories: true)
    try FileManager.default.moveItem(at: sourceUrl, to: targetUrl)
    
    // 仅将存储路径写入Realm
    let realm = try Realm()
    let asset = StaticAsset()
    asset.assetId = assetId
    asset.assetType = "3dModel"
    asset.localPath = targetUrl.path
    try realm.write {
        realm.add(asset, update: .modified)
    }
}

4. 资源读取实现示例 #

func getAssetById(_ assetId: String) throws -> Any? {
    let realm = try Realm()
    guard let asset = realm.object(ofType: StaticAsset.self, forPrimaryKey: assetId) else {
        return nil
    }
    switch asset.assetType {
    case "text":
        return asset.textContent
    case "thumbnail":
        guard let data = asset.assetData else { return nil }
        return UIImage(data: data)
    case "video", "3dModel":
        guard let path = asset.localPath else { return nil }
        return URL(fileURLWithPath: path)
    default:
        return nil
    }
}

优化建议 #

• 若静态资源是随App安装包一起发布的，可以提前把预填充好资源的Realm文件放到App Bundle中，启动时直接拷贝到沙盒路径即可使用，无需首次启动执行写入操作
• 可以在App冷启动时做一次资源完整性校验，对比Realm中的资源记录和本地文件的存在性/MD5值，缺失的资源自动触发重新下载补全
• 不要在Realm中存储单个体积超过100MB的二进制数据，否则会显著提升IO开销，拖慢整个Realm的查询速度

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