Capgo
概述持久 UUID 插件创建一个随机的 RFC 4122 UUID,并将其存储在本机持久性中。使用它时,应用程序需要一个稳定的、应用范围的标识符,能够在应用程序重新安装流程、Android Studio 重新安装周期、应用程序更新和设备 OS 更新中生存。
- getId - 读取存储的 UUID,若无则创建一个 UUID
- resetId - 重新生成 UUID,用于注销、账户重置、隐私重置或测试清理流程
- scope - 使用稳定的命名空间,当 debug 和生产环境使用不同的包标识符时,应共享一个标识符
平台存储
Platform Storage| 平台 | 存储 | 默认作用域 |
|---|---|---|
| Android | AccountManager 账户由插件认证器拥有 | 应用包名 |
| iOS | Keychain通用密码,仅设备可访问 | 包标识符 |
| Web | localStorage 备份 | web |
这不是硬件标识符。它不会在工厂重置、手动账户删除、Keychain清除、浏览器存储清除或显式resetId调用后存活。
公共API
标题:公共API| 方法 | 描述 |
|---|---|
| getId | 读取或创建一个作用域的持久 UUID。 |
| resetId | 替换一个作用域的 UUID。 |
| getPluginVersion | 真实来源 |
来自 src/definitions.ts 的此参考
__CAPGO_KEEP_0__-persistent-uuid继续 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-uuid capacitor-persistent-uuid.
继续从@capgo/capacitor-persistent-uuid
从@capgo/capacitor-persistent-uuid继续如果您正在使用 @capgo/capacitor-persistent-uuid 来识别应用程序安装以跨重新安装流程 连接它与 Getting Started 了解安装和使用 Android 行为 了解 AccountManager 详情 iOS 行为 使用@capgo/capacitor-persistent-uuid 使用 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-uuid @capgo/capacitor-持久账户 当您需要持久化账户数据而不是标识符时。