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

UUID

Erstelle und speichere einen UUID, der auf Anwendungs-Ebene skaliert ist, und überwachst ihn bei Neustarts, Updates der Anwendung und Updates des Betriebssystems

Downloads pro Monat

0

GitHub Sterne

2

Anleitung

Tutorial zur persistenten UUID

Verwenden Sie @capgo/capacitor-persistent-uuid

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

Installieren

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

Was diese Erweiterung bereitstellt

  • getId - Lesen Sie die gespeicherte UUID, erstellen Sie eine, wenn keine für den ausgewählten Bereich existiert.
  • resetId - Rotieren Sie die gespeicherte UUID für Abmeldevorgänge, Datenschutz-Restart oder Test-Entsorgungsabläufe.
  • scope - Optionaler Namensraum für Apps, deren Debug- und Produktionspaket-Identifikatoren sich unterscheiden.

Beispielanwendung

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

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

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

Ein UUID über alle Build-Varianten teilen

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

console.log(result.id);

Der Identifier 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 Paketnamen- oder benutzerdefinierte Scope-Instanz überlebt. iOS speichert die UUID in Keychain und hält sie bei App- und iOS-Updates aufrecht, solange der Zugriff auf Keychain kompatibel bleibt. Web verwendet localStorage als Entwicklungsfall zurück.

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

Weitermachen

Wenn Sie @capgo/capacitor-persistent-uuid um die App-Identität stabil zu halten, mit ihr zu verbinden @capgo/capacitor-persistent-uuid zur Übersicht Anleitung zum Starten für Installations- und API-Beispiele Android-Verhalten für Details zur Wiederinstallation iOS-Verhalten für Details zum Schlüsselkasten und @capgo/capacitor-persistent-account wenn Sie anstelle einer UUID eine Persistenz von Account-Daten benötigen