使用@capgo/capacitor-persistent-uuid

为Capacitor生成一个持久的应用范围UUID，确保其在重新安装和更新流程中保持稳定，甚至在正常应用存储被清除时也能保持稳定。

安装

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

此插件暴露的内容

getId - 读取存储的UUID，创建一个如果不存在的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。

此插件不暴露硬件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-persistent-account @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-account

持久 UUID

__CAPGO_KEEP_0__ Persistent UUID 教程