Guide
Comment utiliser l'UUID persistant dans Capacitor
Utilisation de @capgo/capacitor-uuid-persistent
Générer un UUID persistant d'application unique pour Capacitor et le maintenir stable à travers les flux de réinstallation et de mise à jour où le stockage normal de l'application est supprimé.
Installer
npm install @capgo/capacitor-persistent-uuid
npx cap sync
Ce que ce plugin expose
- getId - Lisez l'UUID stocké, en créant un si aucun n'existe pour le champ sélectionné.
- resetId - Tourner l’UUID stockée pour le déconnexion, le réglage de confidentialité ou les flux de nettoyage de test.
- Étendue - Nom d'espace facultatif pour les applications dont les identifiants de package de débogage et de production diffèrent.
Exemple d'utilisation
import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';
const { id, created, scope } = await PersistentUuid.getId();
console.log(id);
console.log(created);
console.log(scope);
Partager une UUID unique entre les variantes de build
const result = await PersistentUuid.getId({
scope: 'com.example.app',
});
console.log(result.id);
Réinitialiser l'identifiant
const replacement = await PersistentUuid.resetId();
console.log(replacement.id);
Remarques sur les plateformes
Sur Android, l’UUID est stockée dans AccountManager afin de survivre aux cycles de réinstallation d'Android Studio et aux différences de signature de debug et de Play lorsque le nom de package ou l'espace de nom personnalisé est stable. Sur iOS, l’UUID est stockée dans Keychain et reste en place même après mises à jour d'applications et d'iOS tant que l'accès à Keychain reste compatible. Web utilise localStorage comme fallback de développement.
Ce plugin ne révèle pas d'ID matériel et ne survit pas à la réinitialisation de usine, à la suppression manuelle de compte, à la suppression de Keychain, à la suppression de stockage de navigateur ou à la réinitialisation de resetId.
Référence complète
- GitHub: https://github.com/Cap-go/capacitor-uuid-persistante/
- Documentation : /docs/plugins/uuid-persistant/
Continuez
Si vous utilisez @capgo/capacitor-uuid-persistent Pour maintenir l'identité de l'application stable, connectez-l’à @capgo/capacitor-uuid-persistent pour une vue d'ensemble ; Pour commencer pour l'installation et les exemples de API; Comportement Android pour les détails de la réinstallation; Comportement iOS pour les détails de Keychain, et @capgo/capacitor-compte-persistant lorsque vous avez besoin de persistance des données de compte au lieu d'un UUID.