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

UUID persistente

Genera y persiste un UUID de aplicación único a lo largo de reinstalaciones, actualizaciones de la aplicación y actualizaciones del sistema

Guía

Tutoriales sobre UUID persistente

Usando @capgo/capacitor-uuid-persistent

Genera un UUID de aplicación persistente 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 plugin?

  • getId - Lee el UUID almacenado, creando uno si no existe para el ámbito seleccionado.
  • resetId - Rotar la UUID almacenada para logout, 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.

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);

Compartir una UUID a través de variantes de compilació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);

Notas de plataforma

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

Este plugin no expone un ID de hardware y no sobrevive a un reinicio de fábrica, eliminación manual de cuenta, limpieza de Keychain, limpieza de almacenamiento de navegador o resetId.

Referencia completa

Sigue adelante

Si estás utilizando @capgo/capacitor-persistent-uuid para mantener estable la identidad de la aplicación, conecta con @capgo/capacitor-persistent-uuid para obtener una visión general. Iniciar para instalar y obtener ejemplos de API Comportamiento de Android para obtener detalles de reinstalación. Comportamiento de iOS para obtener detalles de la caja de llaves. @capgo/capacitor-cuenta-persistente cuando necesites persistencia de datos de cuenta en lugar de una UUID.