メインコンテンツにスキップ
プラグインに戻る
@capgo/capacitor-persistent-uuid
チュートリアル
@capgo/capacitor-persistent-uuid

UUID

再インストール、アプリケーション更新、OS 更新を含むアプリケーション スコープの UUID を生成して永続化します。

ガイド

__CAPGO_KEEP_0__ の永続的な UUID についてのチュートリアル

capgo/capacitor-persistent-uuid を使用して capgo に一意の永続的なアプリスコープ 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 を読み取り、存在しない場合は 1 つを作成します。

  • resetId - ログアウト、プライバシー リセット、またはテスト クリーンアップ フローで保存された UUID をローテートします。
  • scope - アプリのデバッグとプロダクション パッケージ ID が異なる場合に使用するオプションのネームスペース
  • scope - Optional namespace for apps whose debug and production package identifiers differ.

例外使用

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へのアクセスが互換性がある限り、アプリとiOSの更新を通じて保持します。 Webは、localStorageを開発用のフォールバックとして使用します。

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

フルリファレンス

続ける

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