Aller au contenu

Comportement Android

GitHub

Sur Android, le plugin stocke l'UUID dans AccountManager sous un compte d'authentification propre au plugin. Le nom de compte par défaut utilise le nom de package de l'application comme scope.

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

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 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' });

L’UUID peut être perdu si l’utilisateur supprime le compte dans les paramètres Android, si l’appareil est réinitialisé aux paramètres d’usine, si le package ou le scope change, ou si l’app appelle resetId.

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