再インストール、アプリケーション更新、OS更新をまたがって、1つのアプリケーションスコープのUUIDを生成して保存する - ストアの更新管理をリアルタイムで行うために、__CAPGO_KEEP_0__ アプリケーションに必要な更新を管理する
プラグインに戻る
@capgo/capacitor-persistent-uuid
チュートリアル
@capgo/capacitor-persistent-uuid

パーシステント UUID

再インストール、アプリケーション更新、OS更新を通じてアプリケーションスコープ内の1つのUUIDを生成および永続化する

ガイド

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

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

このプラグインはハードウェアIDを公開せず、ファクトリリセット、手動のアカウント削除、Keychainのクリア、ブラウザのストレージのクリア、またはresetIdの場合に存続しません。

フルリファレンス

進捗を続け

Capgoを使用している場合 @capgo/capacitor-persistent-uuid アプリの固有識別子を安定させるために、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-persistent-uuid @capgo/capacitor-persistent-uuid 概要 Capgoの使い方 CapgoのインストールとAPIの例については、 Androidの動作 再インストールの詳細については、 iOSの動作 Keychainの詳細のために、 @capgo/capacitor-パーシステントアカウント UUIDの代わりにアカウントデータのパーシステンスが必要な場合に