Using @capgo/capacitor-persistent-uuid

Generate one persistent app-scoped UUID for Capacitor and keep it stable across reinstall and update flows where normal app storage is removed.

インストール

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

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

getId - 指定されたスコープで保存されたUUIDを読み取り、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);

ビルドバリアント間で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署名の差異を乗り越えるために、UUIDをAccountManagerに保存します。 iOSでは、KeychainにUUIDを保存し、Keychainへのアクセスが互換性がある限り、アプリとiOSの更新を通じて保持します。 Webでは、localStorageを開発用のフォールバックとして使用します。

このプラグインはハードウェアIDを公開せず、Keychainクリア、ブラウザストレージクリア、またはresetIdによっても存続しません。

フルリファレンス

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

続ける

Capacitor Persistent UUIDプラグインを使用している場合 @capgo/capacitor-persistent-uuid アプリの固有識別子を安定させるために、__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-uuidと接続します。 @capgo/capacitor-persistent-uuid 概要については、 Getting Started インストールとAPIの例については、 Androidの動作再インストールの詳細については、 iOSの動作 Keychainの詳細については、アプリのアカウントデータの永続化が必要な場合は、@capgo/capacitor-persistent-accountを使用してください。 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-account

パーシスタUUID

パーシステント UUIDのチュートリアル