Aller au contenu

@capgo/capacitor-persistent-uuid

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

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

Commencez par getId() et les autres méthodes principales listées ci-dessous.

PlateformeSupportNotes
iOSOuiNatif
AndroidOuiNatif
Le WebNonProtéger avec Capacitor.getPlatform()
  • getId - Lit l'UUID stocké, ou en crée un si aucun n'existe pour le scope sélectionné.
  • resetId - Renouvelez l'UUID pour la déconnexion, la réinitialisation de compte ou de confidentialité, ou le nettoyage de test.
  • scope - Utilisez un namespace stable lorsque les builds de debug et de production utilisent des identifiants de package différents mais doivent partager un identifiant commun.
PlateformeStockagePortée par défaut
AndroidCompte AccountManager détenu par l'authentificateur du pluginNom du package de l'app
iOSMot de passe générique Keychain, accessibilité limitée à l'appareilIdentifiant de bundle
Le Webfallback localStorageweb

Il ne s’agit pas d’un identifiant matériel. Il ne survit pas à une réinitialisation d’usine, à la suppression manuelle du compte, à l’effacement du Keychain, à la suppression du stockage du navigateur ni à un appel explicite à resetId.

MéthodeDescription
getIdLit ou crée l’UUID persistant d’un scope.
resetIdRemplace l’UUID stocké pour un scope.
getPluginVersionRetourne le marqueur de version du plugin natif.

Cette référence est synchronisée depuis src/definitions.ts dans capacitor-persistent-uuid.

Si vous utilisez @capgo/capacitor-persistent-uuid pour identifier une installation d'app à travers les flux de réinstallation, connectez-l’avec Prise en main pour l'installation et l'utilisation, Comportement Android pour les détails sur AccountManager, Comportement iOS pour les détails sur Keychain, Utiliser @capgo/capacitor-persistent-uuid pour le tutoriel, et @capgo/capacitor-persistent-account lorsque vous devez persister des données de compte plutôt qu'un identifiant.