Swift项目如何通过UserDefaults自动预加载初始数据至设备

完全可以通过把预存数据打包进App包的方式解决你的问题，既能避免手动写大量预加载函数导致的Archive耗时，还能实现首次启动自动写入的需求，具体步骤如下：

1. 准备预加载的plist文件 #

• 在Xcode中新建一个Property List文件（命名比如PreloadedFormData.plist），按照你需要存储的表单数据结构，把键值对逐一填入（比如用户名默认值、常用选项列表等），确保数据类型和UserDefaults支持的类型匹配（String、Int、Bool、数组、字典等）。
• 把这个plist文件添加到项目中，勾选对应的Target Membership，确保它会被打包进App的主Bundle里。

2. 实现首次启动自动加载逻辑 #

在App的启动入口（根据你用的UI框架选择对应的位置）添加检测逻辑，判断是否是首次启动，若是则读取Bundle中的plist文件并批量写入UserDefaults：

SwiftUI 示例（App结构体中） #

import SwiftUI

@main
struct YourApp: App {
    init() {
        setupPreloadedData()
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
    
    private func setupPreloadedData() {
        let defaults = UserDefaults.standard
        // 用一个标记判断是否已经完成预加载
        guard !defaults.bool(forKey: "hasCompletedPreload") else { return }
        
        // 读取Bundle中的plist文件
        guard let plistPath = Bundle.main.path(forResource: "PreloadedFormData", ofType: "plist"),
              let preloadedData = NSDictionary(contentsOfFile: plistPath) as? [String: Any] else {
            return
        }
        
        // 批量写入UserDefaults
        preloadedData.forEach { key, value in
            defaults.set(value, forKey: key)
        }
        
        // 标记预加载完成，避免重复执行
        defaults.set(true, forKey: "hasCompletedPreload")
    }
}

UIKit 示例（AppDelegate中） #

import UIKit

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        setupPreloadedData()
        return true
    }
    
    private func setupPreloadedData() {
        let defaults = UserDefaults.standard
        guard !defaults.bool(forKey: "hasCompletedPreload") else { return }
        
        guard let plistPath = Bundle.main.path(forResource: "PreloadedFormData", ofType: "plist"),
              let preloadedData = NSDictionary(contentsOfFile: plistPath) as? [String: Any] else {
            return
        }
        
        preloadedData.forEach { key, value in
            defaults.set(value, forKey: key)
        }
        
        defaults.set(true, forKey: "hasCompletedPreload")
        return
    }
}

关键优势 #

• 替代硬编码的预加载函数，修改数据只需编辑plist文件，无需改动代码重新编译，大幅减少Archive耗时。
• 首次启动自动执行，用户无感知，完全符合你的需求。
• 数据结构可视化，维护起来比写代码更直观。

注意事项 #

• 确保plist中的数据类型和UserDefaults兼容，避免写入失败。
• 如果预加载数据量较大，可以把写入逻辑放到后台队列执行，避免阻塞UI线程：

  DispatchQueue.global(qos: .background).async {
      preloadedData.forEach { key, value in
          defaults.set(value, forKey: key)
      }
      defaults.set(true, forKey: "hasCompletedPreload")
  }
  

• 测试时需要删除App重新安装，才能触发首次启动的预加载逻辑。

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