Guide
Comment utiliser Persistent UUID dans Capacitor
Utiliser @capgo/capacitor-persistent-uuid
Générer un UUID persistant et spécifique à l’application pour Capacitor, stable même après réinstallation ou mise à jour, lorsque le stockage standard de l’application est supprimé.
Installer
npm install @capgo/capacitor-persistent-uuid
npx cap sync
Ce que ce plugin expose
- getId - Lit l'UUID stocké, ou en crée un si aucun n'existe pour le scope sélectionné.
- resetId - Rotate the stored UUID for logout, privacy reset, or test cleanup flows.
- scope - Namespace optionnel pour les apps dont les identifiants de package diffèrent entre debug et production.
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 un seul UUID entre vos 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);
Notes de plateforme
Android stocke l'UUID dans AccountManager pour qu'il survive aux cycles de réinstallation d'Android Studio et aux différences de signature entre debug et Play, tant que le nom de package ou le scope personnalisé reste stable. iOS stocke l'UUID dans le Keychain et le conserve au fil des mises à jour de l'app et d'iOS tant que l'accès au Keychain reste compatible. Le Web utilise localStorage comme fallback de développement.
Ce plugin n'expose pas d'ID matériel et ne survit pas à une réinitialisation d'usine, à la suppression manuelle d'un compte, au vidage du Keychain, au nettoyage du stockage du navigateur ou au resetId.
Référence complète
- GitHub : https://github.com/Cap-go/capacitor-persistent-uuid/
- Docs : /docs/plugins/persistent-uuid/
Continuer
Si vous utilisez @capgo/capacitor-persistent-uuid pour que l'identité de l'app reste stable, connectez-l’à @capgo/capacitor-persistent-uuid pour l'aperçu, Prise en main pour l'installation et des exemples API , Comportement Android pour les détails de réinstallation, Comportement iOS pour les détails du Keychain, et @capgo/capacitor-persistent-account when you need account data persistence instead of a UUID.