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

UUID persistente

Genera y persista una ID UUID de ámbito de aplicación a lo largo de reinstalaciones, actualizaciones de la aplicación y actualizaciones del sistema

Descargas/mes

0

GitHub Estrellas

2

Guía

Tutorial sobre UUID persistente

Usando @capgo/capacitor-persistent-uuid

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

Instalar

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

¿Qué Esta Plugin Exposa

  • getId - Lee el UUID almacenado, creando uno si no existe para el ámbito seleccionado.
  • resetId - Rota el UUID almacenado para logout, reinicio de privacidad o limpieza de pruebas.
  • ámbito - 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 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);

Notas de la Plataforma

Android almacena el 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 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.

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 la visión general, Inicio para instalar y ver ejemplos de API, Comportamiento de Android para detalles de reinstalación, comportamiento de iOS para detalles de Keychain, y @capgo/capacitor-cuenta persistente cuando necesitas persistencia de datos de cuenta en lugar de un UUID.