概览
“概览”章节生成并持久化一个应用级 UUID,在重装、应用更新和系统更新后保持不变
从 getId() 以及下方列出的其他核心方法。
平台支持
标题为“平台支持”的部分| 平台 | 支持 | 备注 |
|---|---|---|
| iOS | 是 | 原生 |
| Android | 是 | 原生 |
| Web 端 | 否 | 使用 Capacitor.getPlatform() 做保护 |
核心功能
标题为“核心功能”的章节- getId - 读取已存储的 UUID,如果所选作用域中不存在则创建一个。
- resetId - 在登出、账户重置、隐私重置或测试清理流程中轮换 UUID。
- scope - 当 debug 和 production 构建使用不同的包标识符但应共享同一标识符时,使用稳定的命名空间。
平台存储
标题为“平台存储”的章节| 平台 | 存储空间 | 默认 scope |
|---|---|---|
| Android | 由插件 authenticator 拥有的 AccountManager 账户 | 应用包名 |
| iOS | Keychain 通用密码,仅限设备访问 | Bundle Identifier |
| Web 端 | localStorage 回退 | web |
这不是硬件标识符。它不会在恢复出厂设置、手动删除账户、清除 Keychain、清除浏览器存储或显式调用 resetId 后保留下来。
公开 API
标题为“公开 API”的章节| 方法 | 描述 |
|---|---|
| getId | 读取或创建指定作用域的持久化 UUID。 |
| resetId | 替换指定作用域中存储的 UUID。 |
| getPluginVersion | 返回原生插件版本标识。 |
单一事实来源
标题为“单一事实来源”的部分此参考文档同步自 中的 src/definitions.ts capacitor-persistent-uuid.
继续探索 @capgo/capacitor-persistent-uuid
标题为“继续探索 @capgo/capacitor-persistent-uuid”的部分如果你正在使用 @capgo/capacitor-persistent-uuid 要在重装流程中识别应用安装,请将其与 快速入门 用于安装和使用, Android 行为 有关 AccountManager 的详细信息, iOS 行为 有关 Keychain 的详细信息, 使用 @capgo/capacitor-persistent-uuid 用于教程,以及 @capgo/capacitor-persistent-account 当您需要持久化账户数据而非标识符时。