Zum Hauptinhalt springen
@capgo/capacitor-persistente-uuid Auth & Sicherheit Offene Quelle

Persistenter UUID Capacitor-Plugin

Erstelle und speichere einen UUID auf App-Ebene, der bei Neustarts, App-Updates und Betriebssystem-Updates erhalten bleibt.

Installieren

bun add @capgo/capacitor-persistent-uuid bunx cap sync
npm, pnpm oder yarn
  • npm install @capgo/capacitor-persistent-uuid
  • pnpm add @capgo/capacitor-persistent-uuid
  • yarn add @capgo/capacitor-persistent-uuid

Guide

Wie man Persistent UUID in Capacitor verwendet

Verwendung von @capgo/capacitor-persistent-uuid

Generiere einen persistenten UUID für Capacitor und halte ihn über die Wiederinstallation und -aktualisierung stabil, wenn normale App-Speicher entfernt werden.

Installieren

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

Was diese Erweiterung enthüllt

  • getId - Lies den gespeicherten UUID, erstelle einen, wenn keiner für den ausgewählten Bereich existiert.
  • resetId - Rotiere den gespeicherten UUID für Abmeldevorgänge, Datenschutzreset oder Testreinigungsflüsse.
  • scope - Optionale 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);

Teile einen UUID über Build-Varianten

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

console.log(result.id);

Resetten Sie die Identifikation

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

Plattformhinweise

Android speichert den UUID in AccountManager, sodass er Android Studio-Wiederinstallationszyklen und Debug- vs. Play-Signierungsunterschiede überlebt, wenn der Paketname oder der benutzerdefinierte Bereich stabil ist. iOS speichert den UUID in Keychain und hält ihn durch App- und iOS-Updates aufrecht, solange der Zugriff auf Keychain kompatibel bleibt. Web verwendet localStorage als Entwicklungsfall zurück.

Dieses Plugin enthält keine Hardware-ID und überlebt weder einen Fabrikneustart, noch eine manuelle Kontoentfernung, eine Leerraumung des Keychains, eine Leerraumung des Browser-Speichers oder einen resetId.

Vollständige Referenz

Los geht's

Wenn Sie verwenden @capgo/capacitor-persistent-UUID Um die App-Identität stabil zu halten, verbinden Sie sie mit @capgo/capacitor-persistent-UUID zur Installation und __CAPGO_KEEP_0__-Beispielen, Getting Started für die Installation und API Beispiele, Android-Verhalten zur Wiederinstallationsdetails, iOS-Verhalten zur Keychain-Detailinformationen, und @capgo/capacitor-persistente-Konto Wenn Sie eine Persistenz von Account-Daten anstelle einer UUID benötigen.

FAQ

FAQ zur Persistent UUID-Plugin

Wie installiere ich das Persistent UUID-Plugin in einer Capacitor-Anwendung?

Führen Sie "bun add @capgo/capacitor-persistent-uuid" (oder "npm install @capgo/capacitor-persistent-uuid"), dann führen Sie "bunx cap sync" aus, damit die iOS- und Android-Projekte die native code-Datei aufnehmen. Importieren Sie sie aus "@capgo/capacitor-persistent-uuid" in Ihrer code-Anwendung.

Funktioniert @capgo/capacitor-persistent-uuid mit React, Vue und Angular?

Ja. Das Persistent UUID-Plugin ist ein Capacitor-Paket, daher funktioniert es mit jedem Webframework, das innerhalb von Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und plain JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-persistent-uuid?

Capgo-Erweiterungen folgen der Capacitor-Version: Wählen Sie die Erweiterungsversion, die Ihrer Capacitor-Version entspricht (z. B. Erweiterung v8 mit Capacitor 8). Die Kompatibilitätsübersicht in der GitHub-README enthält die unterstützten Versionen.

Is @capgo/capacitor-persistent-uuid kostenlos und Open-Source?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-persistent-uuid/ and the package is free to install from npm. Bug reports and pull requests are welcome.

Kann ich code mit Persistent UUID aktualisieren, ohne eine App-Store-Bewertung abzuwarten?

Die Installation oder Aktualisierung der Erweiterung ändert die native code, daher ist eine neue App-Store-Build erforderlich. Anschließend können JavaScript-, HTML- und CSS-Änderungen, die die Erweiterung aufrufen, sofort mit Capgo-Live-Updates bereitgestellt werden.

Persistent UUID-Änderungen ohne Wartezeit auf die App-Überprüfung versenden

Einmal der Plugin im Store Build installiert, werden Capgo lebendige Updates Ihre JavaScript-, HTML- und CSS-Änderungen in Minuten an die Benutzer pushen.

Starten Sie mit Capgo