Zum Inhalt springen

Android-Verhalten

GitHub

Auf Android speichert das Plugin die UUID im AccountManager unter einem vom Plugin verwalteten Authenticator-Account. Der Standard-Accountname verwendet den App-Paketnamen als Scope.

So überlebt die UUID gängige Neuinstallationen, bei denen der app-private Speicher gelöscht wird – einschließlich Uninstall-/Reinstall-Zyklen in Android Studio sowie Installationen mit unterschiedlichen Debug- oder Play-Signing-Keys, solange der Paketname gleich bleibt.

Verwenden Sie den Standard-Scope, wenn der App-Paketname über Builds hinweg stabil ist.

const result = await PersistentUuid.getId();

Verwenden Sie einen benutzerdefinierten Scope, wenn Debug-, Staging- und Produktions-Builds unterschiedliche Paket-Identifikatoren verwenden, aber eine gemeinsame persistente UUID teilen sollen.

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

Die UUID kann verloren gehen, wenn der Benutzer das Konto in den Android-Einstellungen entfernt, das Gerät auf Werkseinstellungen zurückgesetzt wird, sich das Paket/der Scope ändert oder die App resetId aufruft.

Wenn Sie das Verhalten bei einer Android-Neuinstallation validieren, verknüpfen Sie diese Seite mit Erste Schritte für die Verwendung von API, iOS-Verhalten für die Unterschiede auf der Apple-Plattform und @capgo/capacitor-persistent-uuid verwenden für eine vollständige Schritt-für-Schritt-Anleitung.