Guide
Comment utiliser Persistent UUID dans Capacitor
Utiliser @capgo/capacitor-persistent-uuid
Générer un UUID persistant propre à l'app pour Capacitor et le maintenir stable lors des réinstallations et des mises à jour, même quand le stockage classique de l'app 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 - Change l’UUID stocké pour la déconnexion, la réinitialisation de la confidentialité ou le nettoyage des tests.
- 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 maintenir l'identité de l'app 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 quand vous avez besoin de persister les données de compte plutôt qu'un UUID.