SwiftUI：如何实现@AppStorage数据与iCloud同步？

一、保留@AppStorage实现iCloud同步 #

@AppStorage本质是对UserDefaults的封装，可通过后台双向同步UserDefaults与iCloud Key-Value Store（KVS）实现跨设备同步，同时保留@AppStorage的便捷性。核心逻辑是：本地修改时异步同步到iCloud，iCloud有外部更新时同步回UserDefaults，让@AppStorage自动感知变化并更新UI。

实现步骤 #

1. 搭建同步管理器，监听UserDefaults和iCloud KVS的变化事件
2. App启动时从iCloud拉取最新数据覆盖本地，确保新设备能获取历史分数
3. 加入防抖机制，避免频繁同步导致性能问题

代码示例

import Foundation

class iCloudScoreSyncManager {
    static let shared = iCloudScoreSyncManager()
    private let scoreKey = "userScore"
    private var syncDebounceTimer: Timer?

    private init() {
        setupObservers()
        syncFromiCloudToLocal()
    }

    private func setupObservers() {
        // 监听本地UserDefaults变化
        NotificationCenter.default.addObserver(
            self,
            selector: #selector(localScoreChanged),
            name: UserDefaults.didChangeNotification,
            object: nil
        )
        // 监听iCloud KVS外部更新
        NotificationCenter.default.addObserver(
            self,
            selector: #selector(iCloudScoreChanged),
            name: NSUbiquitousKeyValueStore.didChangeExternallyNotification,
            object: nil
        )
    }

    @objc private func localScoreChanged(_ notification: Notification) {
        guard let defaults = notification.object as? UserDefaults,
              let currentScore = defaults.value(forKey: scoreKey) as? Int else { return }

        // 防抖：避免短时间内多次修改触发频繁同步
        syncDebounceTimer?.invalidate()
        syncDebounceTimer = Timer.scheduledTimer(withTimeInterval: 0.5, repeats: false) { [weak self] _ in
            guard let self = self else { return }
            DispatchQueue.global(qos: .background).async {
                NSUbiquitousKeyValueStore.default.set(currentScore, forKey: self.scoreKey)
                NSUbiquitousKeyValueStore.default.synchronize()
            }
        }
    }

    @objc private func iCloudScoreChanged(_ notification: Notification) {
        guard let userInfo = notification.userInfo,
              let reason = userInfo[NSUbiquitousKeyValueStoreChangeReasonKey] as? UInt,
              reason == NSUbiquitousKeyValueStoreChangeReasonServerChange.rawValue else { return }

        if let cloudScore = NSUbiquitousKeyValueStore.default.value(forKey: scoreKey) as? Int {
            // 将iCloud数据同步回本地，@AppStorage会自动更新UI
            UserDefaults.standard.set(cloudScore, forKey: scoreKey)
        }
    }

    private func syncFromiCloudToLocal() {
        if let cloudScore = NSUbiquitousKeyValueStore.default.value(forKey: scoreKey) as? Int {
            UserDefaults.standard.set(cloudScore, forKey: scoreKey)
        }
    }
}

初始化同步管理器

在App启动时初始化，确保监听逻辑生效：

@main
struct YourTestApp: App {
    init() {
        _ = iCloudScoreSyncManager.shared
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

继续使用@AppStorage

原有代码无需修改，保持原有的使用方式即可：

struct ContentView: View {
    @AppStorage("userScore") var userScore = 0

    var body: some View {
        VStack {
            Text("当前分数：\(userScore)")
            Button("加分") {
                userScore += 1
            }
        }
    }
}

二、替代方案 #

1. Core Data + iCloud #

适合需要存储复杂数据的场景，Core Data自带iCloud同步能力，本地读写即时，后台由系统自动处理同步逻辑。配置要点：

• 在Core Data模型文件中启用iCloud，关联对应的iCloud容器
• 确保设备已登录iCloud并开启iCloud Drive
• 代码中正常操作Core Data即可，同步逻辑无需额外编写

2. CloudKit直接存储 #

完全自定义同步逻辑，用CloudKit的CKRecord存储分数，同时维护本地缓存（如UserDefaults或Core Data）：

• 本地更新时先写入缓存，再异步同步到CloudKit
• App启动或后台唤醒时，从CloudKit拉取最新数据更新本地缓存
• 优势是可自定义冲突处理规则，缺点是需要编写更多CloudKit操作代码（查询、保存、错误处理）

三、NSUbiquitiousKeyValueStore性能优化 #

若仍想使用NSUbiquitiousKeyValueStore，可通过以下方式优化速度：

• 用防抖机制减少synchronize()调用次数
• 在后台队列执行同步操作，避免阻塞主线程
• 仅同步必要数据，不要存储大体积内容

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