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

Persistent UUID

Erstelle und speichere einen UUID, der auf Anwendungs-Ebene skaliert ist und bei Neustarts, Updates der App und Updates des Betriebssystems erhalten bleibt

Downloads/Monat

0

GitHub Sterne

2

Anleitung

Tutorial zur persistenten UUID

Verwendung von @capgo/capacitor-persistent-uuid

Generieren Sie eine persistente UUID für Capacitor, die über die Wiederinstallation und -update-Flüsse stabil bleibt, bei denen die normale App-Speicherung entfernt wird.

Installieren

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

Was diese Erweiterung bereitstellt

  • getId - Lese die gespeicherte UUID, erstelle eine, wenn keine für den ausgewählten Bereich existiert.
  • resetId - Rotiere die gespeicherte UUID für Abmeldevorgänge, Datenschutzreset oder Testreinigungsflüsse.
  • scope - Optionaler Namensraum für Apps, deren Debug- und Produktionspackage-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);

Die Identifikation zurücksetzen

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 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ü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 mit @capgo/capacitor-persistent-uuid um eine stabile App-Identität zu erhalten, verbinden Sie sie mit @capgo/capacitor-persistent-uuid für eine Übersicht Anleitung zum Starten für Installations- 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 Persistenz von Account-Daten benötigen.