Aller au contenu principal
@capgo/capacitor-persistent-uuid Auth & sécurité Open source

UUID persistant Plugin Capacitor

Générez et conservez un UUID propre à l'application lors des réinstallations, des mises à jour de l'app et de l'OS

Installer

bun add @capgo/capacitor-persistent-uuid bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-persistent-uuid
  • pnpm add @capgo/capacitor-persistent-uuid
  • yarn add @capgo/capacitor-persistent-uuid

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

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.

FAQ

FAQ du plugin Persistent UUID

Comment installer le plugin Persistent UUID dans une application Capacitor ?

Exécutez « bun add @capgo/capacitor-persistent-uuid » (ou « npm install @capgo/capacitor-persistent-uuid »), puis « bunx cap sync » pour que les projets iOS et Android récupèrent le code natif code. Importez-le depuis « @capgo/capacitor-persistent-uuid » dans votre code code.

Le plugin @capgo/capacitor-persistent-uuid fonctionne-t-il avec React, Vue et Angular ?

Oui. Persistent UUID est un package Capacitor, il fonctionne donc avec n’importe quel framework web exécuté dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor prend en charge @capgo/capacitor-persistent-uuid ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Le plugin @capgo/capacitor-persistent-uuid est-il gratuit et open source ?

Oui. Le code source code est public sur GitHub à l’adresse https://github.com/Cap-go/capacitor-persistent-uuid/ et le package est gratuit à installer depuis npm. Les signalements de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code qui utilise Persistent UUID sans passer par une revue de l’App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements de Persistent UUID sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo