Zum Inhalt springen

@capgo/capacitor-persistent-uuid

Generiert und persistiert eine app-spezifische UUID über Neuinstallationen, App-Updates und OS-Updates hinweg

Generiert und persistiert eine app-spezifische UUID über Neuinstallationen, App-Updates und OS-Updates hinweg

Starte mit getId() und den anderen unten aufgeführten Core-Methoden.

PlattformSupportNotizen
iOSJaNative
AndroidJaNative
WebNeinAbsichern mit Capacitor.getPlatform()
  • getId – Liest die gespeicherte UUID oder erstellt eine neue, falls für den gewählten Scope noch keine existiert.
  • resetId – UUID rotieren für Logout, Account-Reset, Privacy-Reset oder Test-Cleanup-Flows.
  • scope – Nutze einen stabilen Namespace, wenn Debug- und Production-Builds unterschiedliche Package-IDs verwenden, aber dieselbe ID teilen sollen.
PlattformSpeicherStandard-Scope
AndroidAccountManager-Konto, das dem Plugin-Authentifizierer gehörtApp-Paketname
iOSGenerisches Keychain-Passwort, Zugriff nur auf dem GerätBundle-Kennung
WeblocalStorage-Fallbackweb

Dies ist keine Hardware-Kennung. Sie übersteht weder ein Werksreset, das manuelle Entfernen eines Kontos, das Leeren des Keychains, das Leeren des Browser-Speichers noch einen expliziten resetId-Aufruf.

MethodeBeschreibung
getIdLiest oder erstellt die persistente UUID für einen Scope.
resetIdErsetzt die gespeicherte UUID für einen Scope.
getPluginVersionDen Versionsmarker des Native Plugins zurückgeben.

Diese Referenz wird aus src/definitions.ts in capacitor-persistent-uuid.

Wenn du es nutzt @capgo/capacitor-persistent-uuid um eine App-Installation über Reinstall-Flows hinweg zu identifizieren, verknüpfen Sie sie mit Erste Schritte zur Installation und Verwendung, Android-Verhalten für Details zum AccountManager, iOS-Verhalten für Details zum Keychain, @capgo/capacitor-persistent-uuid verwenden für das Tutorial und @capgo/capacitor-persistent-account wenn du Accountdaten statt einer ID persistieren musst.