Android-Verhalten

Speichermodell

Bei Android speichert das Plugin die UUID in AccountManager unter einem Plugin-besitzenen Authentifizierungsaccount. Die Standardaccount-Bezeichnung verwendet den Anwendungs-Paketnamen als Umfang.

Dies ermöglicht es der UUID, bei häufigen Wiederinstallationspfaden, bei denen die app-privaten Speicher entfernt würden, zu überleben, einschließlich Android Studio Wiederinstallationszyklen und Installationszyklen mit unterschiedlichen Debug- oder Play-Signierungsschlüsseln, wenn der Paketname gleich bleibt.

Stabile Umfangsregeln

Verwenden Sie die Standard-Scope, wenn die App-Paket-ID über Builds stabil ist.

const result = await PersistentUuid.getId();

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

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

Grenzen

Die UUID kann verloren gehen, wenn der Benutzer die App aus den Android-Einstellungen entfernt, das Gerät zurücksetzt, die Paket-ID/Scope ändert oder die App resetId aufruft.

Fortsetzen von Android-Verhalten

Wenn Sie das Android-Wiederinstallationsverhalten validieren, verbinden Sie diese Seite mit Anleitung zum Starten für die API-Verwendung, iOS-Verhalten für Unterschiede zwischen Apple-Plattformen und Mit @capgo/capacitor-persistent-uuid für eine umfassende Anleitung.