Androidでの動作

ストレージモデル

Androidでは、このプラグインはAccountManager内のプラグイン専用のauthenticatorアカウントにUUIDを保存します。デフォルトのアカウント名には、アプリのパッケージ名がスコープとして使用されます。

これにより、アプリ専用ストレージが削除される一般的な再インストール時でも、UUIDを保持できます。これには、Android Studioでのアンインストール/再インストールや、パッケージ名が同じで異なるデバッグ用またはPlayストア用の署名キーでインストールした場合などが含まれます。

安定スコープのルール

ビルド間でアプリのパッケージ名が変わらない場合は、デフォルトのスコープを使用してください。

const result = await PersistentUuid.getId();

debug、staging、productionの各ビルドでパッケージ識別子が異なるものの、同一の永続UUIDを共有する必要がある場合は、カスタムスコープを使用してください。

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

制限事項

Androidの設定からアカウントを削除した場合、デバイスを工場出荷状態にリセットした場合、パッケージやスコープが変更された場合、またはアプリがresetIdを呼び出した場合に、UUIDが失われる可能性があります。

Androidの挙動から続ける

Androidの再インストール時の挙動を確認する場合は、こちらのページも併せて参照してください： スタートガイド API の使用方法についてはこちら、 iOSの挙動 Appleプラットフォームの違いについてはこちら、および @capgo/capacitor-persistent-uuidの使用方法 詳細な手順についてはこちらをご覧ください。