iOS 行为

存储模型

在 iOS 上，插件会将 UUID 作为通用密码项存入 Keychain。该项仅限本设备使用，并默认以 bundle identifier 作为作用域。

该数据在应用更新和 iOS 更新后仍会保留。只要 iOS 保留该 Keychain 项，并且应用通过相同的 bundle 和 Apple 团队规则维持兼容的 Keychain 访问权限，重装流程后它也会保留。

稳定的作用域规则

当 bundle identifier 稳定时，请使用默认作用域。

const result = await PersistentUuid.getId();

当多个 build 变体需要解析为同一个 app identifier 时，请使用自定义 scope。

const result = await PersistentUuid.getId({ scope: 'com.example.app' });

限制

如果用户抹除设备、Keychain 数据被清除、Keychain 访问权限变更、bundle/team 访问权限变更，或者 app 调用了 resetId，UUID 可能会丢失。

从 iOS 行为继续

如果你正在验证 iOS 的持久化效果，请参阅 快速入门 关于 API 的用法， Android 行为 关于 Android 的重装行为，以及 使用 @capgo/capacitor-persistent-uuid 查看完整演练。