跳转到正文

@capgo/capacitor-persistent-uuid

生成并持久化一个应用级 UUID,在重装、应用更新和系统更新后保持不变

生成并持久化一个应用级 UUID,在重装、应用更新和系统更新后保持不变

从 getId() 以及下方列出的其他核心方法。

平台支持备注
iOS是原生
Android是原生
Web 端否使用 Capacitor.getPlatform() 做保护
  • getId - 读取已存储的 UUID,如果所选作用域中不存在则创建一个。
  • resetId - 在登出、账户重置、隐私重置或测试清理流程中轮换 UUID。
  • scope - 当 debug 和 production 构建使用不同的包标识符但应共享同一标识符时,使用稳定的命名空间。
平台存储空间默认 scope
Android由插件 authenticator 拥有的 AccountManager 账户应用包名
iOSKeychain 通用密码,仅限设备访问Bundle Identifier
Web 端localStorage 回退web

这不是硬件标识符。它不会在恢复出厂设置、手动删除账户、清除 Keychain、清除浏览器存储或显式调用 resetId 后保留下来。

方法描述
getId读取或创建指定作用域的持久化 UUID。
resetId替换指定作用域中存储的 UUID。
getPluginVersion返回原生插件版本标识。

此参考文档同步自 中的 src/definitions.ts capacitor-persistent-uuid.

如果你正在使用 @capgo/capacitor-persistent-uuid 要在重装流程中识别应用安装,请将其与 快速入门 用于安装和使用, Android 行为 有关 AccountManager 的详细信息, iOS 行为 有关 Keychain 的详细信息, 使用 @capgo/capacitor-persistent-uuid 用于教程,以及 @capgo/capacitor-persistent-account 当您需要持久化账户数据而非标识符时。