跳过主要内容
Capgo logo
返回插件
@capgo/capacitor-persistent-uuid
教程
@capgo/capacitor-persistent-uuid

UUID持久化

在重新安装、应用程序更新和操作系统更新时生成并持久化一个应用程序范围的UUID

每月下载

0

CapgoGitHub星

2

指南

Persistent UUID教程

使用@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访问保持兼容的情况下保持它。 Web使用localStorage作为开发fallback。

此插件不暴露硬件ID，并且不支持factory reset、手动账户删除、Keychain清除、浏览器存储清除或resetId。

完整参考

继续

如果您正在使用 @capgo/capacitor-persistent-uuid 为了保持应用程序身份稳定，连接它 @capgo/capacitor-persistent-uuid 概述 开始使用 安装和API示例 Android行为 重新安装详细信息 iOS行为 Keychain详细信息 @capgo/capacitor-persistent-account 当您需要账户数据持久化而不是UUID时