Saltar al contenido principal
Volver a plugins
@capgo/capacitor-persistent-uuid
Tutoriales
@capgo/capacitor-persistent-uuid

UUID persistente

Genera y persiste un UUID de aplicación que se aplica a reinstalaciones, actualizaciones de la aplicación y actualizaciones del sistema operativo

Guía

Tutorial sobre UUID persistente

Usando @capgo/capacitor-persistent-uuid

Genera un UUID persistente de ámbito de aplicación para Capacitor y manténlo estable a lo largo de los flujos de reinstalación y actualización donde se elimina el almacenamiento normal de la aplicación.

Instalar

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

¿Qué expone este complemento?

  • getId - Lee el UUID almacenado, creando uno si no existe para el ámbito seleccionado.
  • resetId - Rota el UUID almacenado para flujos de cierre de sesión, reinicio de privacidad o limpieza de pruebas.
  • scope - Espacio de nombres opcional para aplicaciones cuyos identificadores de paquete de depuración y producción difieren.

Uso de Ejemplo

import { PersistentUuid } from '@capgo/capacitor-persistent-uuid';

const { id, created, scope } = await PersistentUuid.getId();

console.log(id);
console.log(created);
console.log(scope);

Compartir Un UUID a Través de Variantes de Construcción

const result = await PersistentUuid.getId({
  scope: 'com.example.app',
});

console.log(result.id);

Reiniciar El Identificador

const replacement = await PersistentUuid.resetId();
console.log(replacement.id);

Observaciones de la Plataforma

Android almacena el UUID en AccountManager para que pueda sobrevivir a los ciclos de reinstalación de Android Studio y las diferencias de firmado de depuración vs Play cuando el nombre de paquete o el alcance personalizado es estable. iOS almacena el UUID en Keychain y lo mantiene a través de actualizaciones de la aplicación e iOS mientras el acceso a Keychain sigue siendo compatible. Web utiliza localStorage como fallback de desarrollo.

No se expone este plugin un ID de hardware y no sobrevive a la restauración de fábrica, la eliminación manual de la cuenta, la limpieza de Keychain, la limpieza de almacenamiento de navegador o resetId.

Referencia Completa

Sigue Adelante

Si estás utilizando @capgo/capacitor-persistent-uuid para mantener la identidad de la aplicación estable, conecte con @capgo/capacitor-persistent-uuid para la vista general, Getting Started para instalar y API ejemplos, comportamiento de Android para detalles de reinstalación, comportamiento de iOS para detalles de Keychain, y @capgo/capacitor-persistent-account cuando necesite persistencia de datos de cuenta en lugar de una UUID.