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

UUID プラグイン

再インストール、更新、OS の更新を跨いだアプリのスコープ内で、1 つの UUID を生成して保存します。

ガイド

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

Using @capgo/capacitor-persistent-uuid

CapacitorのパーシステントUUIDを使用して、Capacitorに一意のUUIDを生成し、再インストールおよび更新フローで通常のアプリケーションストレージが削除された場合に安定したUUIDを維持します。

インストール

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

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

  • getId - 指定されたスコープで保存されたUUIDを読み取り、UUIDが存在しない場合は1つを作成します。
  • resetId - ログアウト、プライバシー再設定、またはテストクリーンアップフローのために保存されたUUIDを回転します。
  • scope - アプリのデバッグとプロダクションパッケージ識別子が異なる場合にオプションのネームスペースです。

Example Usage

import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';

const { id, created, scope } = await PersistentUuid.getId();

console.log(id);
console.log(created);
console.log(scope);

Share One UUID Across Build Variants

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

console.log(result.id);

Reset The Identifier

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

Platform Notes

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

This plugin does not expose a hardware ID and does not survive factory reset, manual account removal, Keychain clearing, browser storage clearing, or resetId.

Full Reference

進めていきましょう

Capacitor Persistent UUID を使用している場合 @capgo/capacitor-persistent-uuid Capacitor Persistent UUID を使用してアプリの固有識別子を安定させるには、 @capgo/capacitor-persistent-uuid 概要の場合 Capacitor Persistent UUID を使用してアプリの固有識別子を安定させるには for install and API examples, Capacitor Persistent UUID を使用してアプリの固有識別子を安定させるには Capacitor Persistent UUID を使用してアプリの固有識別子を安定させるには Capacitor Persistent UUID を使用してアプリの固有識別子を安定させるには Capacitor Persistent UUID を使用してアプリの固有識別子を安定させるには capgo/capacitor-persistent-account UUIDの代わりにアカウントデータの永続化が必要な場合。