@capgo/capacitor-persistent-uuid

Übersicht

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

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

Plattformunterstützung

Plattform	Support	Notizen
iOS	Ja	Native
Android	Ja	Native
Web	Nein	Absichern mit Capacitor.getPlatform()

Kernfunktionen

• 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.

Plattform-Speicher

Plattform	Speicher	Standard-Scope
Android	AccountManager-Account, der dem Plugin-Authenticator gehört	App-Package-Name
iOS	Keychain Generic Password, nur auf dem Gerät verfügbar	Bundle-Identifier
Web	localStorage Fallback	Web

Dies ist keine Hardware-ID. Sie bleibt nicht erhalten nach einem Factory Reset, manuellem Account-Löschen, dem Leeren des Keychains, dem Löschen des Browser-Speichers oder einem expliziten resetId-Aufruf.

Öffentliches API

Methode	Beschreibung
getId	Liest die persistente UUID für einen Scope oder erstellt sie.
resetId	Ersetzt die gespeicherte UUID für einen Scope.
getPluginVersion	Den Versionsmarker des Native Plugins zurückgeben.

Source of Truth

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

Weiterlesen bei @capgo/capacitor-persistent-uuid

Wenn du es nutzt @capgo/capacitor-persistent-uuid um eine App-Installation über Neuinstallationen hinweg zu identifizieren, verbinde sie mit Erste Schritte für Installation und Nutzung, Android-Verhalten für AccountManager-Details, iOS-Verhalten für Keychain-Details, @capgo/capacitor-persistent-uuid verwenden für das Tutorial, und @capgo/capacitor-persistent-account wenn du Account-Daten statt einer ID persistieren musst.