Comportamiento en iOS

Modelo de almacenamiento

En iOS, el plugin guarda el UUID en el Keychain como un elemento de contraseña genérica. El elemento es exclusivo del dispositivo y usa el bundle identifier como scope por defecto.

Esto persiste tras actualizaciones de la app y de iOS. También sobrevive a reinstalaciones siempre que iOS mantenga el elemento en el Keychain y la app conserve el acceso compatible mediante el mismo bundle y las reglas de Apple.

Reglas de alcance estables

Usa el scope por defecto cuando el bundle identifier sea estable.

const result = await PersistentUuid.getId();

Usa un scope personalizado si varias variantes de build deben resolver a un mismo identificador de app.

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

Límites

El UUID puede perderse si el usuario borra el dispositivo, se limpia el Keychain, cambian los permisos de Keychain, cambian el bundle/team o si la app llama a resetId.

Continuar con el comportamiento en iOS

Si estás validando la persistencia en iOS, conecta esta página con Primeros pasos para el uso de API, Comportamiento de Android for Android reinstall behavior, and Uso de @capgo/capacitor-persistent-uuid para un tutorial completo.