Comportement Android

Modèle de stockage

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

Ce permet au 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 Android Studio 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 Portée Stable

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

const result = await PersistentUuid.getId();

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

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

Limites

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

Continuez de la même manière de Android Behavior

Si vous validez le comportement de réinstallation Android, connectez cette page avec 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.