指南
如何在 Capacitor 中使用 Persistent UUID
使用 @capgo/capacitor-persistent-uuid
为Capacitor生成一个持久的应用范围UUID，并在正常应用存储被清除的重新安装和更新流程中保持其稳定性。
安装
npm install @capgo/capacitor-persistent-uuid
npx cap sync
此插件暴露的内容
- getId - 读取存储的UUID，若不存在则为选定范围创建一个。
- resetId - 对于注销、隐私重置或测试清理流程，旋转存储的UUID。
- scope - 对于包名或自定义范围稳定的调试和生产包标识符不同的应用，选填的命名空间。
示例使用
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重新安装周期和调试vsPlay签名差异时保持稳定，包名或自定义范围稳定时。 iOS将UUID存储在Keychain中，并在Keychain访问保持兼容的情况下保持其稳定性。 Web使用localStorage作为开发fallback。
此插件不暴露硬件ID，并且不支持工厂重置、手动账户移除、Keychain清除、浏览器存储清除或resetId。
全局参考
- 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时