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
- GitHub: https://github.com/Cap-go/capacitor-persistent-uuid/
- Documentación: /docs/plugins/persistent-uuid/
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.