Guide
Tutoriel sur la UUID persistante
Utiliser @capgo/capacitor-persistent-uuid
Générer une UUID d'application persistante à l'échelle d'une application pour Capacitor et la garder 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
What This Plugin Expose
- getId - Lire l'UUID stocké, en créant un si aucun n'existe pour le champ sélectionné.
- resetId - Roter l'UUID stocké pour la déconnexion, le réglage de la vie privée ou les flux de nettoyage de test.
- scope - Nom de l'espace de noms 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 un UUID à travers 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
Android stocke l'UUID dans AccountManager afin qu'il 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'espace de noms personnalisé est stable. iOS stocke l'UUID dans Keychain et le 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.
Cette extension ne expose pas d'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-persistent-uuid/
- Documentation : /docs/plugins/persistent-uuid/
Continuez à avancer
Si vous utilisez @capgo/capacitor-persistent-uuid pour maintenir l'identité de l'application stable, connectez-le avec @capgo/capacitor-persistent-uuid pour une vue d'ensemble, Prise en main pour l'installation et les exemples de API, Comportement Android pour les détails de reinstallation, comportement iOS pour les détails de Keychain, et @capgo/capacitor-compte persistant lorsque vous avez besoin de la persistance des données de compte au lieu d'un UUID.