Using @capgo/capacitor-persistent-uuid

Capacitor についてのアプリスコープ UUID を 1 つ生成し、再インストールおよび更新フローで通常のアプリストレージが削除された場合に安定するようにします。

インストール

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

このプラグインが公開するもの

getId - 指定されたスコープで UUID を読み取り、存在しない場合は 1 つ作成します。
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);

ビルドバリアント間で1つのUUIDを共有する

const result = await PersistentUuid.getId({
  scope: 'com.example.app',
});

console.log(result.id);

識別子をリセットする

const replacement = await PersistentUuid.resetId();
console.log(replacement.id);

プラットフォームの注記

Androidは、パッケージ名またはカスタムスコープが安定している場合に、Android Studioの再インストールサイクルとデバッグ対Play署名の違いを乗り越えるために、AccountManagerにUUIDを保存します。 iOSはKeychainにUUIDを保存し、Keychainへのアクセスが互換性がある限り、AppとiOSの更新を通じて保持されます。 WebはlocalStorageを開発用のフォールバックとして使用します。

このプラグインはハードウェアIDを公開せず、factory reset、手動アカウントの削除、Keychainのクリア、ブラウザのストレージのクリア、またはresetIdを実行しても存続しません。

フルリファレンス

GitHub https://github.com/Cap-go/capacitor-persistent-uuid/
ドキュメント: /docs/plugins/persistent-uuid/

続ける

使用中の場合 @capgo/capacitor-persistent-uuid アプリの固有識別子を安定させるために、__CAPGO_KEEP_0__に接続する @capgo/capacitor-persistent-uuid 概要のために Getting Started インストールとAPIの例のために Androidの動作再インストールの詳細のために iOSの動作 Keychainの詳細のために @capgo/capacitor-persistent-account UUIDの代わりにアカウントデータの永続化が必要な場合

UUID

パーシステント UUID についてのチュートリアル