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

Androidでの動作

GitHub

Android では、プラグインは UUID を AccountManager 内のプラグインが所有する認証アカウントに保存します。デフォルトのアカウント名では、アプリのパッケージ名がスコープとして使われます。

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

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

const result = await PersistentUuid.getId();

デバッグ、ステージング、本番環境のビルドでパッケージ識別子が異なるが、1つの永続 UUID を共有する場合は、カスタムスコープを使用してください。

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

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

Android の再インストール動作を検証している場合は、このページを以下に接続してください。 スタートガイド API の使用方法についてはこちら、 iOSの挙動 Apple プラットフォームの差異については、 @capgo/capacitor-persistent-uuid を使用する 完全なウォークスルーはこちら。