Saltar al contenido principal
logotipo de Capgo
Volver a plugins
@capgo/capacitor-uuid-persistente
Tutorial
@capgo/capacitor-uuid-persistente

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

Descargas/mes

0

GitHub Estrellas

2

Guía

Tutoría sobre UUID persistente

Using @capgo/capacitor-persistent-uuid

Generate one persistent app-scoped UUID for Capacitor and keep it stable across reinstall and update flows where normal app storage is removed.

Qué se expone con este plugin

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

getId - Leer el UUID almacenado, creando uno si no existe para el ámbito seleccionado.

  • resetId - Rotar el UUID almacenado para flujos de cierre de sesión, 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.
  • scope - Optional namespace for apps whose debug and production package identifiers differ.

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 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 la Plataforma

Android almacena el UUID en AccountManager para que pueda sobrevivir a ciclos de reinstalación de Android Studio y 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 y de iOS mientras que 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 una restauración de fábrica, la eliminación manual de cuentas, 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 visión general, Iniciación 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.