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

Persistent UUID

Einen UUID auf Anwendungs-Ebene generieren und bei Wiederinstallationen, Updates der Anwendung und Updates des Betriebssystems persistieren

Richtlinie

Tutorial zur persistenten UUID

Verwenden Sie @capgo/capacitor-persistent-uuid

Einen persistenten UUID auf Anwendungs-Ebene für Capacitor generieren und ihn bei Wiederinstallation und Update-Flüssen stabil halten, bei denen normale Anwendungs-Speicherung entfernt wird.

Installieren

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

Was Diese Erweiterung Enthält

  • getId - Die gespeicherte UUID lesen, eine erstellen, wenn keine für den ausgewählten Bereich existiert.
  • resetId - Die gespeicherte UUID für Abmeldevorgänge, Datenschutzreset oder Testreinigungen rotieren.
  • scope - Optionaler Namensraum für Apps, deren Debug- und Produktionspaketidentifikatoren sich unterscheiden.

Beispielhafte 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 Alle Build-Varianten Teilen

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

console.log(result.id);

Die Identifikator Zerstören

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

Plattformhinweise

Android speichert die UUID in AccountManager, damit sie Android Studio-Wiederinstallationszyklen und Debug- vs. Play-Signierungsunterschiede überlebt, wenn der Paketname oder der benutzerdefinierte Bereich 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-back.

Diese Erweiterung enthält keine Hardware-ID und überlebt weder einen Fabrikneustart, eine manuelle Kontoentfernung, eine Keychain-Lösung, eine Browser-Speicherlöschung noch einen resetId.

Vollständige Referenz

Weitermachen

Wenn Sie @capgo/capacitor-persistent-uuid für eine stabile App-Identität verwenden, verbinden Sie es mit @capgo/capacitor-persistent-uuid für eine Übersicht, Einstieg für die Installation und API-Beispiele, Android-Verhalten für Details zum Wiederinstallieren, iOS-Verhalten für Details zum Schlüsseltresor und @capgo/capacitor-persistente-Konto wenn Sie anstelle einer UUID eine Persistenz von Kontodaten benötigen.