Passer au contenu principal
Lors de la création d’applications mobiles sur Replit, vous pouvez rencontrer des problèmes avec les aperçus, le bundling ou les dépendances de packages. Ce guide vous aide à résoudre les problèmes courants, en commençant par des correctifs rapides et en progressant vers des étapes de débogage plus approfondies.

​
Correctifs rapides

Essayez ces solutions en premier — elles résolvent la plupart des problèmes :
ProblèmeQue faire
Les modifications n’apparaissent pas sur votre téléphoneSecouez votre téléphone pour ouvrir le menu Expo, puis appuyez sur Recharger
Les modifications n’apparaissent pas dans l’aperçuAppuyez sur R dans la console pour relancer le bundling
L’application est bloquée ou ne répond pasArrêtez et redémarrez l’application depuis la console

​
Problèmes courants

Lorsque vous apportez des modifications mais ne les voyez pas sur votre téléphone :
  1. Secouez votre téléphone pour ouvrir le menu développeur Expo
  2. Appuyez sur Recharger pour retélécharger le bundle
Sur l’aperçu web, appuyez sur R dans la console pour déclencher un nouveau bundling.Si les modifications n’apparaissent toujours pas, essayez de vider le cache (voir Vider le cache Metro ci-dessous).
Un écran d’erreur rouge indique généralement une erreur JavaScript ou un module manquant. Lisez le message d’erreur — il pointe souvent vers le fichier et la ligne spécifiques.Causes courantes :
  • Un package n’est pas installé ou est dans la mauvaise version
  • Un module fonctionne sur le web mais pas en natif (ou vice versa)
  • Une erreur de syntaxe dans votre code
Que faire :
  1. Lisez attentivement le message d’erreur — il vous dit souvent exactement ce qui ne va pas
  2. Demandez à Agent de vous aider à corriger l’erreur en partageant le message
  3. Si l’erreur mentionne un package spécifique, essayez de réinstaller les dépendances (voir Réinstaller les packages)
Certains packages ou fonctionnalités fonctionnent différemment selon les plateformes. React Native se compile vers trois cibles : iOS, Android et web. Une bibliothèque qui fonctionne sur le web peut ne pas prendre en charge le natif, ou peut nécessiter une configuration différente.Que faire :
  1. Vérifiez si le package prend en charge votre plateforme dans sa documentation
  2. Demandez à Agent : « Ce package est-il compatible avec Expo Go ? »
  3. Envisagez de déplacer la fonctionnalité vers votre serveur si elle n’est pas prise en charge sur mobile
Lors de la recherche de packages, cherchez « compatible Expo » ou consultez la documentation Expo SDK pour les modules pris en charge.
Vérifiez votre réseau :
  • Votre téléphone et votre ordinateur doivent être sur le même réseau WiFi
  • Certains réseaux d’entreprise ou publics bloquent la connexion
Essayez le mode tunnel : Si vous êtes sur un réseau restreint, le mode tunnel achemine le trafic via les serveurs d’Expo. Demandez à Agent de démarrer l’application en mode tunnel, ou exécutez npx expo start --tunnel dans le shell.Redémarrez Expo Go : Fermez complètement Expo Go et rouvrez-le avant de scanner.
Le premier build est toujours plus lent car il n’y a pas de cache. Les builds suivants devraient être plus rapides.Ce qui affecte le temps de build :
  • Nombre de packages dans votre projet
  • Première exécution après avoir vidé le cache
  • Vitesse du réseau lors du téléchargement des packages
Si les builds sont constamment lents, vérifiez si vous avez des packages inutiles installés.
Lorsque vous voyez « Unable to resolve module » ou « Module not found » :
  1. Le package n’est peut-être pas installé — demandez à Agent de l’installer
  2. Le package est peut-être installé mais le cache est obsolète — videz le cache
  3. Le package n’existe peut-être pas ou est mal orthographié — vérifiez le nom du package
Essayez de réinstaller les packages si le module devrait exister.

​
Commandes de débogage

Lorsque les correctifs rapides ne fonctionnent pas, ces commandes aident à réinitialiser les différents caches et états. Exécutez-les dans le Shell.

​
Vider le cache Metro

Metro est le bundler qui compile votre code React Native. Vider son cache force un nouveau build. Dans le shell, exécutez : 
npx expo start --clear
Cela vide le cache du bundler et redémarre le serveur de développement. Vous verrez « Bundler cache is empty. Rebuilding. » dans la sortie.
Si vous rencontrez fréquemment des problèmes de cache, vous pouvez ajouter -c à votre commande de démarrage. Demandez à Agent de mettre à jour la commande dev pour inclure le flag de vidage.

​
Réinstaller les packages

Si vous observez des erreurs de module ou des incompatibilités de versions, réinstaller les packages aide souvent. Dans le shell, exécutez : 
rm -rf node_modules && npm install
Cela supprime tous les packages installés et les réinstalle depuis le début en se basant sur votre package.json.
Si votre projet utilise un gestionnaire de packages différent (comme bun ou pnpm), utilisez la commande d’installation appropriée : bun install ou pnpm install.

​
Vérifier les incompatibilités de versions

Expo Doctor analyse votre projet pour détecter les problèmes courants comme les incompatibilités de versions entre les packages. Dans le shell, exécutez : 
npx expo-doctor
Examinez la sortie pour les avertissements. Si des corrections sont suggérées, évaluez-les attentivement — ne mettez pas à jour les packages à l’aveugle, car cela peut introduire de nouveaux problèmes.
Ne mettez à jour les packages que lorsqu’il y a une raison spécifique de le faire. Mettre à niveau « juste parce que » peut casser votre application si la nouvelle version comporte des changements incompatibles.

​
Réinitialisation complète

Lorsque rien d’autre ne fonctionne, une réinitialisation complète vide tous les caches et réinstalle tout.
Cette commande supprime tous les caches et réinstalle les packages depuis le début. Utilisez-la en dernier recours.
rm -rf node_modules .expo && npm cache clean --force && npm install && npx expo start --clear
Ce que cela fait :
  1. rm -rf node_modules — Supprime les packages installés
  2. rm -rf .expo — Supprime le cache local d’Expo
  3. npm cache clean --force — Vide le cache global de npm
  4. npm install — Réinstalle tous les packages
  5. npx expo start --clear — Démarre avec un cache Metro vierge
Après l’exécution, votre prochain build prendra plus de temps car tout est reconstruit depuis le début.

​
Vider le cache sur votre appareil

Si l’application sur votre téléphone semble bloquée avec du code ancien même après le rechargement :
  • iOS : Dans Expo Go, accédez à Paramètres et appuyez sur Vider le cache
  • Android : Accédez à Paramètres > Applications > Expo Go > Stockage > Vider le cache

​
Référence rapide

ProblèmeEssayez d’abordPuis essayez
Les modifications n’apparaissent pasSecouez le téléphone → RechargerVider le cache Metro
Erreurs de bundlernpx expo start --clearSupprimer node_modules
Module introuvableRéinstaller les dépendancesRéinitialisation complète
Avertissements d’incompatibilité de versionsExécuter npx expo-doctorÉvaluer les corrections suggérées
Nouveau package ne fonctionne pasRedémarrer le serveurVider le cache Metro
Modification de app.jsonRedémarrer le serveur—

​
Obtenir plus d’aide

Si vous êtes toujours bloqué :
  • Demandez à Agent : Décrivez l’erreur et ce que vous avez essayé. Agent peut souvent diagnostiquer et corriger les problèmes.
  • Consultez la documentation Expo : Le guide de dépannage Expo couvre des scénarios supplémentaires.
  • Recherchez l’erreur : Copiez le message d’erreur exact et effectuez une recherche — quelqu’un l’a probablement déjà rencontré.

​
Prochaines étapes