如何在SwiftUI中实现Quick Notes NSUserActivity属性丢失问题咨询

架构老林

2026-10-1

SwiftUI NSUserActivity标识符丢失问题解决方案

你遇到的是SwiftUI的已知实现问题，并非配置错误。SwiftUI的userActivity(_:update:)修饰符在序列化NSUserActivity时，目前不会持久化persistentIdentifier和targetContentIdentifier两个属性，只有userInfo等基础字段会被正常传输和恢复。

可用解决方案

补充缺失的必填配置
要支持Quick Notes功能，首先需要在updateUserActivity方法中新增属性配置：
```
activity.isEligibleForPersistentStore = true
activity.requiredUserInfoKeys = ["id"] // 明确指定需要持久化的userInfo键，避免系统丢弃字段
```
同时确认你的活动类型已在Info.plist的NSUserActivityTypes数组中完成注册。
兼容现有逻辑的临时方案
因为userInfo字段可以正常恢复，你可以优先从userInfo中读取唯一标识符实现业务逻辑，无需依赖丢失的两个属性，完全可以满足Quick Notes的匹配需求：
```
private func continueUserActivity(_ activity: NSUserActivity) {
    guard let id = activity.userInfo?["id"] as? String else { return }
    // 用id完成后续逻辑即可
}
```
完全保留系统属性的方案
如果你必须使用persistentIdentifier和targetContentIdentifier系统属性，需要放弃SwiftUI的userActivity修饰符，改用UIKit/AppKit原生的生命周期方法管理NSUserActivity：
比如在UIKit的ViewController中重写updateUserActivityState(_:)方法设置属性，原生方法序列化时不会丢失这两个字段。