Saltar al contenido principal
@capgo/capacitor-persistent-uuid Auth y seguridad Código abierto

UUID persistente plugin Capacitor

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

Instalar

bun add @capgo/capacitor-persistent-uuid bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-persistent-uuid
  • pnpm add @capgo/capacitor-persistent-uuid
  • yarn add @capgo/capacitor-persistent-uuid

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

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.

FAQ

FAQ del plugin Persistent UUID

¿Cómo instalo el plugin Persistent UUID en una app de Capacitor?

Ejecuta "bun add @capgo/capacitor-persistent-uuid" (o "npm install @capgo/capacitor-persistent-uuid"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android detecten el code nativo. Impórtalo desde "@capgo/capacitor-persistent-uuid" en el code de tu app.

¿Es compatible @capgo/capacitor-persistent-uuid con React, Vue y Angular?

Sí. Persistent UUID es un paquete de Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-persistent-uuid?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-persistent-uuid gratuito y open source?

Sí. El código fuente code es público en GitHub: https://github.com/Cap-go/capacitor-persistent-uuid/ y el paquete se puede instalar gratis desde npm. Se aceptan informes de errores y pull requests.

¿Puedo actualizar code que usa Persistent UUID sin una revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Publica cambios en Persistent UUID sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo