Guide
Tutoriel sur l'UUID persistant
Utiliser @capgo/capacitor-uuid-persistent
Générez un UUID persistant d'application pour Capacitor et maintenez-le 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 plugin expose
- getId - Lisez l'UUID stocké, en créant un si aucun n'existe pour le champ sélectionné.
- resetId - Rotatez l'UUID stocké pour les flux de déconnexion, de réinitialisation de la vie privée ou de nettoyage de test.
- scope - Champ de namespace optionnel pour les applications dont les identificateurs 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);
Partagez une UUID à travers les variantes de build
const result = await PersistentUuid.getId({
scope: 'com.example.app',
});
console.log(result.id);
Réinitialisez l'identifiant
const replacement = await PersistentUuid.resetId();
console.log(replacement.id);
Remarques de plateforme
Android stocke la UUID dans AccountManager afin qu'elle survive aux cycles de réinstallation d'Android Studio et aux différences de signature de débogage et de Play lorsque le nom de package ou l'étendue personnalisée est stable. iOS stocke la UUID dans Keychain et la conserve à travers les 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 met pas en évidence un ID matériel et ne survit pas à la réinitialisation de la fabrique, à la suppression manuelle du compte, à la suppression de Keychain, à la suppression de stockage de navigateur ou à la fonction resetId.
Référence complète
- GitHub: https://github.com/Cap-go/capacitor-uuid-persistante/
- Docs: /docs/plugins/uuid-persistant/
Continuez
Si vous utilisez @capgo/capacitor-persistent-uuid pour maintenir l'identité de l'application stable, connectez-la avec @capgo/capacitor-persistent-uuid pour le résumé, Démarrage pour l'installation et les exemples de API Comportement Android pour les détails de réinstallation, Comportement iOS pour les détails de la clé de chaîne, et @capgo/capacitor-persistent-account lorsque vous avez besoin de la persistance des données de compte au lieu d'un UUID.