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.

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

Limites

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

Continuer depuis le comportement Android

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.