Comportement iOS

Modèle de stockage

Sur iOS, le plugin stocke l'UUID dans Keychain sous forme d'élément de mot de passe générique. L'élément est uniquement sur le dispositif et utilise l'identifiant de bundle comme champ de portée par défaut.

Cette configuration résiste aux mises à jour d'applications et aux mises à jour d'iOS. Elle résiste également aux flux de réinstallation tant que iOS garde l'élément Keychain et que l'application garde un accès compatible à Keychain à travers le même bundle et les règles d'équipe d'Apple.

Règles de champ de portée stable

Utilisez le champ de portée par défaut lorsque l'identifiant de bundle est stable.

const result = await PersistentUuid.getId();

Utilisez un champ de portée personnalisé lorsque plusieurs variantes de build doivent se résoudre à un identifiant d'application unique.

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

Limites

Le UUID peut être perdu si l'utilisateur efface le dispositif, les données de Keychain sont supprimées, les accès à Keychain changent, les accès au bundle/équipe changent ou l'application appelle resetId.

Continuer depuis le comportement iOS

Si vous validez la persistance iOS, connectez cette page à Démarrage pour l'utilisation de API Comportement Android pour le comportement de réinstallation Android, et Utilisation de @capgo/capacitor-persistent-uuid pour une présentation complète.