Comportement sur Android

Modèle de stockage

Sur Android, le plugin stocke l'UUID dans l'AccountManager via un compte authentificateur appartenant au plugin. Le nom de compte par défaut utilise le nom du package de l'application comme scope.

Cela permet à l'UUID de survivre aux réinstallations classiques qui supprimeraient le stockage privé de l'application, notamment les cycles de désinstallation/réinstallation d'Android Studio et les installations signées avec différentes clés de debug ou de Play Store, tant que le nom du package reste identique.

Règles de portée stables

Utilisez le scope par défaut si le nom du package de l'app est stable entre les builds.

const result = await PersistentUuid.getId();

Utilisez un scope personnalisé lorsque les builds de debug, staging et production utilisent des identifiants de package différents mais doivent partager un même UUID persistant.

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

Limites

L'UUID peut être perdu si l'utilisateur supprime le compte dans les paramètres Android, si l'appareil subit une réinitialisation d'usine, si le package/scope change, ou si l'application appelle resetId.

Continuer depuis le comportement Android

Si vous validez le comportement de réinstallation sur Android, consultez également Prise en main pour l'usage de API, Comportement iOS pour les différences sur les plateformes Apple, et Utiliser @capgo/capacitor-persistent-uuid pour un guide complet.