Zum Hauptinhalt springen
Zurück zu Plugins
@capgo/capacitor-persistent-uuid
Anleitung
@capgo/capacitor-persistent-uuid

Erstelle und speichere einen UUID, der auf Anwendungs-Ebene skaliert ist, und überwachst Anwendungs- und Betriebssystem-Updates

Downloads/Monat

Ansehen auf __CAPGO_KEEP_0__

Anleitung

Using @capgo/capacitor-persistent-uuid

Verwenden Sie @Capacitor/__CAPGO_KEEP_1__-persistent-uuid

Erstellen Sie eine persistente UUID für __CAPGO_KEEP_0__ und halten Sie sie stabil über die Wiederherstellung und Aktualisierungsabläufe, bei denen die normale App-Speicherung entfernt wird.

npm install @capgo/capacitor-persistent-uuid
npx cap sync

Installieren

  • Was diese Erweiterung freigibt: getId - Lesen Sie die gespeicherte UUID, erstellen Sie eine, wenn keine für den ausgewählten Bereich existiert.
  • resetId - Die gespeicherte UUID für Abmeldevorgänge, Datenschutzreset oder Testreinigungsflüsse neu generieren.
  • scope - Optionaler Namensraum für Apps, deren Debug- und Produktionspakete unterschiedliche Identifikatoren haben.

Beispielische Verwendung

import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';

const { id, created, scope } = await PersistentUuid.getId();

console.log(id);
console.log(created);
console.log(scope);

Eine UUID über verschiedene Build-Varianten teilen

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

console.log(result.id);

Die Identifikationsnummer zurücksetzen

const replacement = await PersistentUuid.resetId();
console.log(replacement.id);

Plattformhinweise

Android speichert die UUID in AccountManager, sodass sie bei Android Studio-Wiederinstallationszyklen und Debug- vs. Play-Signierungsunterschieden über eine stabile Paketname oder einen benutzerdefinierten Scope überlebt. iOS speichert die UUID in Keychain und hält sie bei App- und iOS-Updates bei kompatibler Keychain-Zugriffsberechtigung. Web verwendet localStorage als Entwicklungsfall-back.

Diese Erweiterung enthüllt keine Hardware-ID und überlebt nicht bei Fabrikneustart, manueller Kontoentfernung, Keychain-Löschen, Browser-Speicherlöschen oder resetId.

Vollständige Referenz

Weitergehen

Wenn Sie @capgo/capacitor-persistent-uuid um eine stabile App-Identität zu erhalten, verbinden Sie es mit @capgo/capacitor-persistent-uuid für eine Übersicht Anleitung zum Starten for install and API examples, @__CAPGO_KEEP_0__ Beispiele Verhalten auf Android für Details zum Wiederinstallieren, iOS-Verhalten @capgo/capacitor-persistente-Konto Wenn Sie eine Persistenz von Account-Daten anstelle einer UUID benötigen.