Comportement Android

Modèle de stockage

Sur Android, le plugin stocke l'UUID dans AccountManager sous un compte de vérificateur appartenant au plugin. Le nom de compte par défaut utilise le nom de package de l'application comme champ de portée.

Cela permet à l'UUID de survivre aux chemins d'installation courants où le stockage privé de l'application serait supprimé, y compris les cycles d'installation/désinstallation de Studio Android et les installations signées avec des clés de débogage ou de Play différentes lorsque le nom de package reste le même.

Règles de champ stable

Utilisez le champ par défaut lorsque le nom de package de l'application est stable entre les builds.

const result = await PersistentUuid.getId();

Utilisez un champ personnalisé lorsque les builds de débogage, de pré-production et de production utilisent des identifiants de package différents mais devraient partager une UUID persistante.

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

Limits

La UUID peut être perdue si l'utilisateur supprime le compte des paramètres Android, si le dispositif est réinitialisé d'usine, si le package/scope change ou si l'application appelle resetId.

Continuez de la section Android Behavior

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