Comportamiento en Android

Modelo de almacenamiento

En Android, el plugin almacena el UUID en AccountManager bajo una cuenta de autenticador propiedad del plugin. El nombre de cuenta por defecto usa el package name de la app como scope.

Esto permite que el UUID sobreviva a reinstalaciones comunes donde el almacenamiento privado de la app se eliminaría, incluyendo ciclos de desinstalación/reinstalación en Android Studio e instalaciones firmadas con distintas debug o Play signing keys si el package name se mantiene igual.

Reglas de alcance estables

Usa el scope por defecto cuando el package name de la app sea estable entre builds.

const result = await PersistentUuid.getId();

Usa un scope personalizado cuando los builds de debug, staging y producción usen diferentes package identifiers pero deban compartir un mismo UUID persistente.

const result = await PersistentUuid.getId({ scope: 'com.example.app' });

Límites

El UUID puede perderse si el usuario elimina la cuenta desde los ajustes de Android, si el dispositivo se restablece de fábrica, si cambia el package/scope o si la app llama a resetId.

Continuar desde el comportamiento de Android

Si estás validando el comportamiento de reinstalación en Android, consulta esta página junto con Primeros pasos para el uso de API, Comportamiento en iOS para las diferencias en plataformas Apple, y Uso de @capgo/capacitor-persistent-uuid para una guía completa.