For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /fr/docs/mobile/troubleshooting.md (or send Accept: text/markdown).
Dépannage de l’application mobile
Corrigez les échecs courants d’aperçu, de configuration et de build natif avant qu’ils n’atteignent un testeur.
Configuration et paramètres
Si l’application ne joint pas le backend, rappelez-vous que localhost sur un téléphone désigne le téléphone. Utilisez l’adresse LAN de l’ordinateur, 10.0.2.2 pour l’émulateur Android ou une URL HTTPS de staging. Ouvrez d’abord cette adresse dans le navigateur du téléphone ; vérifiez le Wi-Fi, le pare-feu et le VPN avant de modifier le code. Un tunnel Expo transporte le bundle d’écran, pas votre API.
Un EXPO_PUBLIC_API_URL absent ou incorrect apparaît comme erreur de configuration avant la connexion. Un callback refusé signifie souvent que le schéma du build et MOBILE_ALLOWED_ORIGINS du serveur ne concordent pas, ou que le callback a été exécuté dans Expo Go plutôt que dans le build natif.
Processus d’implémentation
Après un changement de dépendance native ou de schéma, arrêtez Metro, videz son cache, reconstruisez le client de développement et réinstallez l’application. Si seul le JavaScript a changé, recharger l’aperçu suffit. Gardez la version du SDK Expo de l’application alignée sur Expo Go ou le build de développement installé sur l’appareil.
Vérification et dépannage
L’aperçu, la connexion et le lien profond fonctionnent sur l’appareil cible.