Zum Inhalt springen

@capgo/capacitor-persistent-uuid

Persistente UUID für Capacitor.

Das Plugin für persistente UUIDs generiert eine zufällige UUID nach RFC 4122 und speichert sie mit nativer Persistenz. Verwenden Sie es, wenn Ihre App eine stabile, app-basierte Identifikator benötigt, der auch bei App-Wiederinstallationsflüssen, Android Studio-Wiederinstallationszyklen, App-Updates und Geräte-OS-Updates überlebt.

  • getId - Die gespeicherte UUID lesen, eine erstellen, wenn keine für den ausgewählten Bereich existiert.
  • resetId - Die UUID für Abmeldevorgänge, Konto- und Datenschutzrücksetzungen sowie Testreinigungsflüsse rotieren.
  • scope - Bei Debug- und Produktionsbuilds ein stabiles Namensraum verwenden, wenn unterschiedliche Paketidentifikatoren verwendet werden, aber ein gemeinsamer Identifier verwendet werden soll.
PlattformSpeicherStandardbereich
AndroidAccountManager-Konto, das vom Plugin-Authenticator gehalten wirdPaketname der App
iOSAllgemeiner Schlüssel für das Keychain, nur GerätezugriffBundle-Identifier
WeblocalStorage-Fallbackweb

Dies ist kein Hardware-identifier. Er überlebt weder einen Factory-Reset, noch eine manuelle Konto-Entfernung, eine Keychain-Löschen, eine Browser-Speicher-Löschen oder einen expliziten resetId-Aufruf.

MethodeBeschreibung
getIdLese oder erstelle die dauerhafte UUID für einen Bereich.
resetIdErsetze die gespeicherte UUID für einen Bereich.
getPluginVersionGib die native Pluginversion zurück.

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

Wenn Sie eine App verwenden @capgo/capacitor-persistent-uuid um eine App-Installation über verschiedene Wiederinstallierungs-Flows zu identifizieren, verbinden Sie es mit Einstieg für die Installation und Verwendung Android-Verhalten für Details zum AccountManager iOS-Verhalten für Details zum Keychain Verwendung von @capgo/capacitor-persistent-uuid für das Tutorial und @capgo/capacitor-persistent-account Wenn Sie Account-Daten persistieren müssen, anstatt eine Identifikationsnummer zu verwenden.