Guía
Cómo usar Persistent UUID en Capacitor
Uso de @capgo/capacitor-persistent-uuid
Genera un UUID persistente para Capacitor que se mantenga estable tras reinstalaciones o actualizaciones, incluso si se borra el almacenamiento local de la app.
Instalar
npm install @capgo/capacitor-persistent-uuid
npx cap sync
Lo que expone este plugin
- getId - Lee el UUID almacenado, creando uno nuevo si no existe para el scope seleccionado.
- resetId - Rota el UUID almacenado para flujos de logout, reinicio de privacidad o limpieza de pruebas.
- scope - Namespace opcional para apps con identificadores de paquete distintos en debug y producción.
Ejemplo de uso
import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';
const { id, created, scope } = await PersistentUuid.getId();
console.log(id);
console.log(created);
console.log(scope);
Comparte un mismo UUID entre variantes de build
const result = await PersistentUuid.getId({
scope: 'com.example.app',
});
console.log(result.id);
Reinicia el identificador
const replacement = await PersistentUuid.resetId();
console.log(replacement.id);
Notas de la plataforma
Android almacena el UUID en AccountManager para que sobreviva a reinstalaciones de Android Studio y diferencias de firma entre debug y Play Store si el package name o el scope personalizado es estable. iOS guarda el UUID en Keychain y lo mantiene tras actualizaciones de la app o de iOS mientras el acceso a Keychain sea compatible. Web usa localStorage como fallback de desarrollo.
Este plugin no expone un ID de hardware y no sobrevive a un factory reset, eliminación manual de cuenta, limpieza de Keychain, limpieza de almacenamiento del navegador o a resetId.
Referencia completa
- GitHub: https://github.com/Cap-go/capacitor-persistent-uuid/
- Docs: /docs/plugins/persistent-uuid/
Continuar
Si estás usando @capgo/capacitor-persistent-uuid para mantener estable la identidad de la app, conéctala con @capgo/capacitor-persistent-uuid para el resumen, Primeros pasos para la instalación y ejemplos de API, Comportamiento de Android para detalles de reinstalación, Comportamiento en iOS para detalles del Keychain, y @capgo/capacitor-persistent-account cuando necesites persistencia de datos de cuenta en lugar de un UUID.