指南
如何在 Capacitor 中使用 Persistent UUID
使用 @capgo/capacitor-persistent-uuid
为Capacitor生成一个持久的应用范围UUID，并在正常应用存储被移除的重新安装和更新流程中保持其稳定。
安装
npm install @capgo/capacitor-persistent-uuid
npx cap sync
此插件暴露的内容
- getId - 读取存储的UUID，如果不存在则为选定范围创建一个。
- resetId - 对于注销、隐私重置或测试清理流程，旋转存储的UUID。
- scope - 选项命名空间，用于应用包标识符在debug和production环境下不同时的应用。
示例使用
import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';
const { id, created, scope } = await PersistentUuid.getId();
console.log(id);
console.log(created);
console.log(scope);
在多个构建变体之间共享一个UUID
const result = await PersistentUuid.getId({
scope: 'com.example.app',
});
console.log(result.id);
重置标识符
const replacement = await PersistentUuid.resetId();
console.log(replacement.id);
平台说明
Android将UUID存储在AccountManager中，使其能够在Android Studio重新安装周期和debug vs Play签名差异时保持稳定，包名或自定义范围稳定时。
iOS将UUID存储在Keychain中，并在Keychain访问保持兼容的情况下保持其稳定性，通过应用和iOS更新。Web使用localStorage作为开发fallback。
全局参考
- GitHub: https://github.com/Cap-go/capacitor-persistent-uuid/
- 文档：/docs/plugins/persistent-uuid/
继续
如果您正在使用 @capgo/capacitor-persistent-uuid 来保持应用程序身份稳定，连接它 @capgo/capacitor-persistent-uuid 以获取概述 开始 获取安装和API示例 Android 行为 重新安装详细信息 iOS 行为 Keychain 详细信息 @capgo/capacitor-持久账户 当您需要账户数据持久化而不是 UUID 时