Allez directement au contenu principal
Capgo logo
Retour aux plugins
@capgo/capacitor-uuid-persistent
Tutoriel
@capgo/capacitor-uuid-persistent

UUID persistant

Générez et persistez un UUID d'application unique à travers les réinstallations, les mises à jour d'applications et les mises à jour du système d'exploitation

Téléchargements/mois

0

GitHub étoiles

2

Guide

Tutoriel sur l'UUID persistant

Utiliser @capgo/capacitor-uuid-persistent

Générez un UUID persistant d'application à l'échelle pour Capacitor et maintenez-le 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

Ce plugin expose

  • getId - Lisez l'UUID stocké, en créant un si aucun n'existe pour le champ sélectionné.
  • resetId - Rotatez l'UUID stocké pour les flux de déconnexion, de réinitialisation de la vie privée ou de nettoyage de test.
  • scope - Champ de namespace optionnel pour les applications dont les identifiants de package de débogage et de production diffèrent.

Utilisation d'exemple

import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';

const { id, created, scope } = await PersistentUuid.getId();

console.log(id);
console.log(created);
console.log(scope);

Partagez une UUID à travers les variantes de build

const result = await PersistentUuid.getId({
  scope: 'com.example.app',
});

console.log(result.id);

Réinitialisez l'identifiant

const replacement = await PersistentUuid.resetId();
console.log(replacement.id);

Remarques sur la plateforme

Sur Android, l’UUID est stockée dans AccountManager afin de survivre 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 nom personnalisé est stable. Sur iOS, l’UUID est stockée dans Keychain et reste en place même après mises à jour de l'application et de l'iOS tant que l'accès à Keychain reste compatible. Sur Web, localStorage est utilisé comme fallback de développement.

Cette extension ne met pas en évidence 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 la storage du navigateur ou à la fonction resetId.

Référence complète

Continuez

Si vous utilisez @capgo/capacitor-persistent-uuid pour maintenir l'identité de l'application stable, connectez-l’avec @capgo/capacitor-persistent-uuid pour une vue d'ensemble Démarrage pour l'installation et les exemples de API Comportement Android pour les détails de reinstallation Comportement iOS pour les détails de la clé de chaîne, et @capgo/capacitor-persistent-account lorsque vous avez besoin de la persistance des données de compte au lieu d'un UUID.