Passer au contenu principal
Logo Capgo
Retour aux plugins
@capgo/capacitor-persistent-uuid
Tutoriel
@capgo/capacitor-persistent-uuid

UUID persistant

Générer et conserver un UUID d'application à l'échelle d'une application, à travers les réinstallations, les mises à jour d'application et les mises à jour du système d'exploitation

Téléchargements/mois

0

GitHub étoiles

2

Guide

Tutoriel sur les UUID persistants

Utiliser @capgo/capacitor-persistent-uuid

Générer un UUID persistant d'application pour Capacitor et le conserver stable à travers les flux de réinstallation et de mise à jour où les données d'application normales sont supprimées.

Installer

npm install @capgo/capacitor-persistent-uuid
npx cap sync

Ce Plugin Expose

  • getId - Lire l'UUID stocké, en créant un si aucun n'existe pour le champ sélectionné.
  • resetId - Roter l'UUID stocké pour les flux de déconnexion, de réinitialisation de la confidentialité ou de nettoyage de test.
  • scope - Nom de domaine optionnel pour les applications dont les identifiants de package de débogage et de production diffèrent.

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);

Partager un UUID à travers les variantes de construction

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);

Remarques sur les plateformes

Android stocke l'UUID dans AccountManager afin qu'il survive 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'étendue personnalisée est stable. iOS stocke l'UUID dans Keychain et le conserve à travers les mises à jour d'applications et d'iOS tant que l'accès à Keychain reste compatible. Web utilise localStorage comme fallback de développement.

Ce plugin ne met pas en évidence un ID matériel et ne survit pas à la réinitialisation de la fabrique, à la suppression manuelle du compte, à la suppression de Keychain, à la suppression des données de 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-la à @capgo/capacitor-persistent-uuid pour l'aperçu, Démarrage pour l'installation et les exemples de API Comportement Android pour les détails de réinstallation, 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.