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

UUID persistente

Erstelle und speichere einen UUID auf App-Ebene, der bei Wiederinstallierung, App-Updates und OS-Updates erhalten bleibt

Downloads/Monat

0

GitHub Sterne

2

Richtlinie

Tutorial zur persistenten UUID

Mit @capgo/capacitor-persistent-uuid verwenden

Generieren Sie eine persistente UUID für Capacitor und halten Sie sie 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 - 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 Testreinigungsflüsse drehen.
  • scope - Optionaler Namensraum für Apps, deren Debug- und Produktionspaketidentifikatoren 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);

Richten Sie Die Identifikator zurück

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 überleben kann, 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 Entwickler-Backup.

Diese Erweiterung enthüllt keine Hardware-ID und überlebt keinen Fabrikneustart, manuellen Account-Entfernung, Keychain-Löschen, Browser-Speicherlöschen oder resetId.

Vollständige Referenz

Weitermachen

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