Android Behavior

Speichermodell

On Android speichert das Plugin die UUID in AccountManager unter einem vom Plugin besitzenen Authentifizierungsaccount. Die Standardaccountbezeichnung verwendet den Anwendungspackage-Namen als Scope.

Dies ermöglicht es der UUID, übliche Wiederinstallationspfade zu überstehen, in denen die app-private Speicherung entfernt würde, einschließlich Android Studio Wiederinstallationszyklen und Installationszyklen mit verschiedenen Debug- oder Play-Signierungsschlüsseln, wenn der Paketname gleich bleibt.

Stabile Scope-Regeln

Verwenden Sie den Standard-Scope, wenn der Anwendungs-Paketname über Builds stabil bleibt.

const result = await PersistentUuid.getId();

Verwenden Sie einen benutzerdefinierten Scope, wenn Debug-, Staging- und Produktionsbuilds unterschiedliche Paketidentifikatoren verwenden, aber eine persistente UUID teilen sollen.

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

Grenzen

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

Fortsetzen von Android-Verhalten

Wenn Sie das Android-Wiederinstallationsverhalten überprüfen, verbinden Sie diese Seite mit Einstieg für die API-Verwendung, iOS-Behavior für Unterschiede in der Apple-Plattform und Mit @capgo/capacitor-persistent-uuid für einen umfassenden Leitfaden.