使用 @capgo/capacitor-persistent-uuid

为Capacitor生成一个持久的应用范围 UUID，并在重新安装和更新流程中保持稳定，正常应用存储被移除。

安装

npm install @capgo/capacitor-persistent-uuid
npx cap sync

此插件暴露的内容

getId - 读取存储的 UUID，如果不存在则创建一个 UUID，根据所选范围
resetId - 对于注销、隐私重置或测试清理流程，旋转存储的 UUID
scope - 应用程序的 debug 和生产包标识符不同时的可选命名空间

示例用途

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访问保持兼容的情况下保持它。 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示例安卓行为重新安装详细信息 iOS行为 Keychain详细信息 @capgo/capacitor-persistent-account 当您需要账户数据持久化而不是UUID时

UUID持久化

关于持久 UUID 的教程