Saltar al contenido

Comportamiento en Android

GitHub

En Android, el plugin almacena el UUID en AccountManager bajo una cuenta de autenticador propiedad del plugin. El nombre de cuenta predeterminado usa el nombre del paquete de la app como ámbito.

Esto permite que el UUID sobreviva a las rutas de reinstalación comunes donde se eliminaría el almacenamiento privado de la app, incluidos los ciclos de desinstalación/reinstalación en Android Studio e instalaciones firmadas con claves de depuración o de Play diferentes cuando el nombre del paquete permanece igual.

Usa el ámbito predeterminado cuando el nombre del paquete de la app es 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' });

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.

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.