Comportement iOS

Modèle de stockage

Sur iOS, le plugin stocke l'UUID dans le Keychain en tant qu'élément de type mot de passe générique. L'élément est propre à l'appareil et utilise l'identifiant du bundle comme scope par défaut.

Cela survit aux mises à jour de l'application et d'iOS. Cela survit également aux réinstallations, tant qu'iOS conserve l'élément Keychain et que l'application maintient un accès Keychain compatible via le même bundle et les règles de l'équipe Apple.

Règles de portée stables

Utilisez le scope par défaut lorsque l'identifiant du bundle est stable.

const result = await PersistentUuid.getId();

Utilisez un scope personnalisé lorsque plusieurs variantes de build doivent correspondre à un seul identifiant d'application.

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

Limites

L’UUID peut être perdu si l'utilisateur efface l'appareil, si les données Keychain sont vidées, si l'accès au Keychain change, si l'accès au bundle/team change, ou si l'application appelle resetId.

Continuer depuis le comportement iOS

Si vous vérifiez la persistance sur iOS, mettez cette page en relation avec Prise en main pour l'usage de API, Comportement Android for Android reinstall behavior, and Utiliser @capgo/capacitor-persistent-uuid pour un guide complet.