Comportement Android

Modèle de stockage

Sur Android, le plugin stocke l'UUID dans AccountManager sous un compte d'authentificateur dédié 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 l'ensemble par défaut lorsque le nom de package de l'application est stable entre les builds.

const result = await PersistentUuid.getId();

Utilisez un champ d'application personnalisé lors des builds de débogage, de pré-production et de production, même si les identifiants de package diffèrent, pour partager une UUID persistante unique.

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

Limites

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

Continuez de la section « Comportement Android »

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