メインコンテンツへスキップ

Androidでの動作

GitHub

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の再インストール時の挙動を確認する場合は、こちらのページを併せて参照してください: スタートガイド API の使用方法についてはこちら、 iOSの挙動 Appleプラットフォームの違いについてはこちら、および @capgo/capacitor-persistent-uuid を使用する 完全なウォークスルーはこちら。