@capgo/capacitor-persistent-uuid

概览

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

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

平台支持

平台	支持	备注
iOS	是	原生
Android	是	原生
Web 端	否	使用 Capacitor.getPlatform() 做保护

核心功能

• getId - 读取已存储的 UUID；如果当前作用域下不存在，则创建一个新的。
• resetId - 轮换 UUID，适用于注销、账号重置、隐私重置或测试清理流程。
• scope - 当调试版和生产版使用不同的包名但需要共享同一个标识符时，请使用稳定的命名空间。

平台存储

平台	存储空间	默认作用域
Android	由插件验证器拥有的 AccountManager 账户	应用包名
iOS	Keychain 通用密码，仅限设备访问	Bundle 标识符
Web 端	localStorage 回退方案	web

这并非硬件标识符。在恢复出厂设置、手动删除账号、清除 Keychain、清除浏览器存储或显式调用 resetId 时，该 ID 将失效。

公开 API

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

单一事实来源

此参考文档同步自 src/definitions.ts，位于 capacitor-persistent-uuid.

继续探索 @capgo/capacitor-persistent-uuid

如果你正在使用 @capgo/capacitor-persistent-uuid 用于在重新安装流程中识别应用安装，并将其与 快速入门 用于安装和使用： Android 行为 查看 AccountManager 详情， iOS 行为 查看 Keychain 详情， 使用 @capgo/capacitor-persistent-uuid 查看教程，以及 @capgo/capacitor-persistent-account 当你需要持久化账户数据而非标识符时。