アプリの再インストール、アップデート、OSの更新後も維持される、アプリ固有のUUIDを生成・保存します
まずはこちらから getId() および以下に示すその他のコアメソッド。
プラットフォーム対応
「プラットフォーム対応」という見出しのセクション| プラットフォーム | サポート | 備考 |
|---|---|---|
| iOSと | はい | ネイティブ |
| Android | はい | ネイティブ |
| Web | いいえ | Capacitor.getPlatform() でガード |
コア機能
「コア機能」セクション- getId - 保存されているUUIDを読み取ります。指定したスコープにUUIDが存在しない場合は新規作成します。
- resetId - ログアウト、アカウントのリセット、プライバシー設定のリセット、またはテスト後のクリーンアップフローでUUIDを更新します。
- scope - デバッグ用と本番用のビルドでパッケージ識別子が異なるものの、同一の識別子を共有する必要がある場合に、安定した名前空間を使用します。
プラットフォーム・ストレージ
「プラットフォーム・ストレージ」というタイトルのセクション| プラットフォーム | ストレージ | デフォルトのスコープ |
|---|---|---|
| Android | プラグインの認証者が所有するAccountManagerアカウント | アプリのパッケージ名 |
| iOSと | Keychainのgeneric password（デバイス限定のアクセシビリティ） | Bundle identifier |
| Web | localStorage フォールバック | web |
これはハードウェア識別子ではありません。工場出荷時設定へのリセット、手動によるアカウント削除、Keychain の消去、ブラウザストレージの消去、または resetId の明示的な呼び出しによって消失します。
公開 API
「Public API」セクション| メソッド | 説明 |
|---|---|
| getId | 指定したスコープの永続的な UUID を取得または作成します。 |
| resetId | 指定したスコープの保存済み UUID を置き換えます。 |
| getPluginVersion | ネイティブプラグインのバージョンマーカーを返します。 |
Source of Truth
「Source Of Truth」セクションこのリファレンスは、以下の src/definitions.ts から同期されています： capacitor-persistent-uuid.
@capgo/capacitor-persistent-uuid の続き
「@capgo/capacitor-persistent-uuid の続き」セクション使用している場合 @capgo/capacitor-persistent-uuid 再インストール時でもアプリのインストールを識別するために、これを以下と連携させます： スタートガイド インストールと使用方法についてはこちら： Androidでの動作 AccountManager の詳細は、 iOSの挙動 Keychain の詳細は、 @capgo/capacitor-persistent-uuid を使用する チュートリアルについては、 @capgo/capacitor-persistent-account 識別子ではなくアカウントデータを永続化したい場合に。
