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

UUID-Persistenz

Erstelle und speichere einen UUID auf Anwendungs-Ebene, der bei Wiederherstellungen, Updates der Anwendung und Updates des Betriebssystems erhalten bleibt

Downloads pro Monat

0

GitHub Sterne

2

Richtlinie

Tutorial zu persistenten UUID

Mit @capgo/capacitor-persistent-uuid verwenden

Erstellen Sie einen persistenten app-basierten UUID für Capacitor und halten Sie ihn stabil über Wiederinstallations- und Aktualisierungsflüsse, bei denen normale App-Speicher entfernt werden.

Installieren

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

Was diese Erweiterung offenlegt

  • getId - Lesen Sie den gespeicherten UUID, erstellen Sie einen, wenn keiner für den ausgewählten Bereich existiert.
  • resetId - Drehen Sie den gespeicherten UUID für Abmeldevorgänge, Datenschutz-Restart oder Test-Entsorgungsflüsse.
  • scope - Optionale 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);

Teilen Sie eine UUID über Build-Varianten

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

console.log(result.id);

Resetten Sie Die Identifikationsnummer

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

Plattformhinweise

Android speichert die UUID in AccountManager, damit sie Android Studio-Wiederherstellungszyklen und Debug- vs. Play-Signierungsunterschiede überlebt, wenn der Paketnamen oder der benutzerdefinierte Scope stabil ist. iOS speichert die UUID in Keychain und hält sie durch App- und iOS-Updates aufrecht, solange der Zugriff auf Keychain kompatibel bleibt. Web verwendet localStorage als Entwicklungsfall zurück.

Diese Erweiterung enthält keine Hardware-ID und überlebt nicht durch Fabrikneustart, manuelle Kontoentfernung, Keychain-Löschen, Browser-Speicherlöschen oder resetId.

Vollständige Referenz

Weitermachen

Wenn Sie diese verwenden @capgo/capacitor-persistent-uuid um die App-Identität stabil zu halten, verbinden Sie sie mit @capgo/capacitor-persistent-uuid für die Übersicht, Getting Started für die Installation und API-Beispiele, Android-Verhalten für Details zum Wiederinstallieren, iOS-Verhalten für Details zum Keychain und @capgo/capacitor-persistent-account wenn Sie anstelle einer UUID eine Account-Daten-Persistenz benötigen.