@capgo/capacitor-persistent-uuid

Resumen

Genera y persiste un UUID de la app entre reinstalaciones, actualizaciones de app y de SO

Empieza con getId() y los demás métodos principales detallados abajo.

Soporte de plataformas

Plataforma	Soporte	Notas
iOS	Sí	Nativo
Android	Sí	Nativo
Web	No	Protege con Capacitor.getPlatform()

Funcionalidades principales

• getId - Lee el UUID almacenado, creando uno nuevo si no existe para el scope seleccionado.
• resetId - Rota el UUID para flujos de logout, reinicio de cuenta, privacidad o limpieza de tests.
• scope - Usa un namespace estable si los builds de debug y producción usan distintos package identifiers pero deben compartir el mismo.

Almacenamiento de la plataforma

Plataforma	Almacenamiento	Ámbito por defecto
Android	Cuenta de AccountManager propiedad del autenticador del plugin	Nombre del paquete de la app
iOS	Contraseña genérica de Keychain, accesibilidad solo dispositivo	Identificador del bundle
Web	fallback de localStorage	web

No es un identificador de hardware. No sobrevive a un factory reset, a la eliminación manual de la cuenta, al borrado del Keychain, a la limpieza del almacenamiento del navegador o a una llamada explícita a resetId.

Público API

Método	Descripción
getId	Lee o crea el UUID persistente para un scope.
resetId	Reemplaza el UUID almacenado para un scope.
getPluginVersion	Devuelve el marcador de versión del plugin nativo.

Fuente de verdad

Esta referencia se sincroniza desde src/definitions.ts en capacitor-persistent-uuid.

Continúa con @capgo/capacitor-persistent-uuid

Si estás usando @capgo/capacitor-persistent-uuid para identificar una instalación de app en flujos de reinstalación, conéctalo con Primeros pasos para instalar y usar, Comportamiento de Android para detalles de AccountManager, Comportamiento en iOS para detalles de Keychain, Uso de @capgo/capacitor-persistent-uuid para el tutorial, y @capgo/capacitor-persistent-account cuando necesites persistir datos de cuenta en lugar de un identificador.