Android-Verhalten
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
Speichermodell
Abschnitt „Storage Model“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.
Stabile Scope-Regeln
Abschnitt „Stable Scope Rules“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.
Weiter mit Android-Verhalten
Abschnitt mit dem Titel „Weiter mit Android-Verhalten“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.