Android-Verhalten

Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.

Speichermodell

Unter Android speichert das Plugin die UUID im AccountManager unter einem Authenticator-Account, der dem Plugin gehört. Der Standard-Accountname nutzt den App-Package-Namen als Scope.

Dadurch bleibt die UUID auch bei Neuinstallationen erhalten, bei denen privater App-Speicher gelöscht würde – etwa bei Uninstall/Reinstall-Zyklen in Android Studio oder bei Installationen mit unterschiedlichen Debug- oder Play-Signing-Keys, sofern der Package-Name gleich bleibt.

Stabile Scope-Regeln

Verwende den Standard-Scope, wenn der App-Package-Name über verschiedene Builds hinweg stabil bleibt.

const result = await PersistentUuid.getId();

Verwenden Sie einen benutzerdefinierten Scope, wenn Debug-, Staging- und Production-Builds unterschiedliche Package-IDs nutzen, aber dieselbe persistente UUID teilen sollen.

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

Limits

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

Weiter mit Android-Verhalten

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