コンテンツにジャンプ

Androidの動作

GitHub

Android上では、プラグインはアカウントマネージャー下のUUIDをプラグイン所有の認証者アカウント下に格納します。デフォルトのアカウント名はアプリパッケージ名をスコープとして使用します。

この機能により、UUIDはアプリプライベートストレージが削除される一般的な再インストールパスを乗り越え、Android Studioのアンインストール/再インストールサイクルや、パッケージ名が同じままの場合に署名キーが異なるデバッグまたはPlay署名キーで署名されたインストールも乗り越えます。

アプリパッケージ名がビルド間で安定している場合にデフォルトスコープを使用します。

const result = await PersistentUuid.getId();

デバッグ、ステージング、生産ビルドが異なるパッケージ識別子を使用する場合にでも、異なるパッケージ識別子を使用するビルド間で共有する一つの永続UUIDを使用する場合にカスタムスコープを使用します。

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

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

Androidの再インストール動作を検証している場合、このページを 「Getting Started」 for API usage, __CAPGO_KEEP_0__の使用については 「iOSの動作」 Using @capgo/capacitor-persistent-uuid Appleプラットフォームの違いについては