アプリの再インストール、アプリの更新、OSの更新後も保持される、アプリ固有のUUIDを生成・保存します
まずは getId() および以下に示すその他のコアメソッド。
プラットフォーム対応
「プラットフォーム対応」という見出しのセクション| プラットフォーム | サポート | 備考 |
|---|---|---|
| iOSと | はい | ネイティブ |
| Androidでは | はい | ネイティブ |
| Web | いいえ | Capacitor.getPlatform() でガード |
コア機能
「コア機能」セクション- getId - 保存されているUUIDを読み取ります。指定したスコープにUUIDが存在しない場合は新規作成します。
- resetId - ログアウト、アカウントリセット、プライバシーリセット、またはテストクリーンアップフローのために UUID をローテーションします。
- scope - デバッグビルドと本番ビルドで異なるパッケージ識別子を使用する場合でも、1つの識別子を共有する必要がある場合は、安定した名前空間を使用します。
プラットフォームストレージ
セクション「プラットフォームストレージ」| プラットフォーム | ストレージ | デフォルトの scope |
|---|---|---|
| Androidでは | プラグインの認証者が所有する AccountManager アカウント | アプリのパッケージ名 |
| iOSと | Keychain の汎用パスワード、デバイスでのみアクセス可能 | バンドル識別子 |
| 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 識別子ではなくアカウントデータを永続化したい場合に。