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 y crea uno si no existe para el scope seleccionado.
- resetId - Rota el UUID almacenado para flujos de logout, reset 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);
Restablece el identificador
const replacement = await PersistentUuid.resetId();
console.log(replacement.id);
Notas de la plataforma
Android guarda el UUID en AccountManager para que sobreviva a reinstalaciones desde Android Studio y a las diferencias de firma entre debug y Play si el package name o el scope personalizado se mantienen estables. iOS guarda el UUID en Keychain y lo conserva tras actualizaciones de la app y de iOS mientras el acceso a Keychain siga siendo compatible. Web usa localStorage como fallback de desarrollo.
Este plugin no expone un ID de hardware y no sobrevive a un factory reset, la eliminación manual de la cuenta, el borrado del Keychain, el borrado del almacenamiento del navegador o resetId.
Referencia completa
- GitHub: https://github.com/Cap-go/capacitor-persistent-uuid/
- Docs: /docs/plugins/persistent-uuid/
Sigue adelante
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 ejemplos de instalación y de API, Comportamiento de Android para más detalles sobre la reinstalación, Comportamiento en iOS para más detalles sobre Keychain, y @capgo/capacitor-persistent-account cuando necesites persistencia de datos de cuenta en lugar de un UUID.