Guía
Cómo usar UUID persistente en Capacitor
Usando @capgo/capacitor-uuid-persistent
Genera un UUID persistente para Capacitor y manténlo estable a lo largo de la reinstalación y actualización, incluso cuando se elimina el almacenamiento normal de la aplicación.
Instalar
npm install @capgo/capacitor-persistent-uuid
npx cap sync
¿Qué este plugin expone?
- getId - Lee el UUID almacenado, creando uno si no existe para el alcance seleccionado.
- resetId - Rotar la UUID almacenada 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.
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);
Restablecer el identificador
const replacement = await PersistentUuid.resetId();
console.log(replacement.id);
Observaciones de 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 espacio de nombres personalizado es estable. iOS almacena el UUID en Keychain y lo mantiene a través de actualizaciones de la aplicación y 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 la 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
- GitHub: https://github.com/Cap-go/capacitor-uuid-persistent/
- Documentación: /docs/plugins/uuid-persistent/
Sigue adelante
Si estás utilizando @capgo/capacitor-uuid persistente para mantener estable la identidad de la aplicación, conecta con @capgo/capacitor-uuid persistente para la visión general Para empezar para instalar y ejemplos de API Comportamiento de Android para detalles de reinstalación Comportamiento de iOS para detalles de Keychain y @capgo/capacitor-cuenta-persistente en lugar de una UUID cuando necesitas persistencia de datos de cuenta.