Anleitung
Persistent UUID in Capacitor nutzen
@capgo/capacitor-persistent-uuid verwenden
Erzeuge eine einzige persistente, app-spezifische UUID für Capacitor und halte sie über Neuinstallations- und Update-Abläufe hinweg stabil, bei denen der normale App-Speicher gelöscht wird.
Installieren
npm install @capgo/capacitor-persistent-uuid
npx cap sync
Was dieses Plugin bereitstellt
- getId – Liest die gespeicherte UUID oder erstellt eine neue, falls für den gewählten Scope noch keine existiert.
- resetId – Erneuert die gespeicherte UUID für Logout-, Privacy-Reset- oder Test-Cleanup-Flows.
- scope – Optionaler Namespace für Apps, deren Debug- und Production-Package-IDs voneinander abweichen.
Anwendungsbeispiel
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 hinweg teilen
const result = await PersistentUuid.getId({
scope: 'com.example.app',
});
console.log(result.id);
Identifier zurücksetzen
const replacement = await PersistentUuid.resetId();
console.log(replacement.id);
Plattform-Hinweise
Android speichert die UUID im AccountManager, sodass sie Android Studio Reinstall-Zyklen und Unterschiede zwischen Debug- und Play-Signing übersteht, sofern der Package-Name oder der Custom Scope stabil bleibt. iOS speichert die UUID im Keychain und behält sie auch bei App- und iOS-Updates bei, solange der Keychain-Zugriff kompatibel bleibt. Web nutzt localStorage als Fallback für die Entwicklung.
Dieses Plugin gibt keine Hardware-ID preis und bleibt bei einem Factory Reset, manuellem Account-Löschen, Keychain-Löschen, Browser-Storage-Löschen oder durch resetId nicht erhalten.
Vollständige Referenz
- GitHub: https://github.com/Cap-go/capacitor-persistent-uuid/
- Docs: /docs/plugins/persistent-uuid/
Weiter
Wenn du es nutzt @capgo/capacitor-persistent-uuid Um die App-Identität stabil zu halten, verbinde sie mit @capgo/capacitor-persistent-uuid für die Übersicht, Erste Schritte für Installations- und API-Beispiele, Android-Verhalten für Details zur Neuinstallation, iOS-Verhalten für Keychain-Details, und @capgo/capacitor-persistent-account wenn du Account-Daten-Persistenz statt einer UUID benötigst.