Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Lors du développement 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 solutions rapides et en progressant vers des étapes de débogage plus approfondies.

​
Solutions 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 re-télécharger le bundle
Dans 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 sur natif (ou vice versa)
  • 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 d’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 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 du SDK Expo 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.
La première compilation est toujours plus lente car il n’y a pas de cache. Les compilations suivantes devraient être plus rapides.Ce qui affecte le temps de compilation :
  • Nombre de packages dans votre projet
  • Première exécution après avoir vidé le cache
  • Vitesse réseau lors du téléchargement des packages
Si les compilations sont constamment lentes, 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 solutions rapides ne fonctionnent pas, ces commandes aident à réinitialiser divers 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 une nouvelle compilation. 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 de développement pour inclure le drapeau clear.

​
Réinstaller les packages

Si vous voyez des erreurs de module ou des incompatibilités de version, 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 fonction de 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 version

Expo Doctor analyse votre projet pour détecter les problèmes courants comme les incompatibilités de version entre les packages. Dans le shell, exécutez : 
npx expo-doctor
Examinez la sortie pour les avertissements. S’il suggère des corrections, évaluez-les soigneusement — ne mettez pas à jour les packages aveuglément, 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 a 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 avoir exécuté cela, votre prochaine compilation 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 vieux code même après rechargement :
  • iOS : Dans Expo Go, allez dans Paramètres et appuyez sur Vider le cache
  • Android : Allez dans Paramètres > Applications > Expo Go > Stockage > Vider le cache

​
Référence rapide

ProblèmeEssayer d’abordPuis essayer
Les modifications n’apparaissent pasSecouez le téléphone → RechargerVider le cache Metro
Erreurs du bundlernpx expo start --clearSupprimer node_modules
Module introuvableRéinstaller les dépendancesRéinitialisation complète
Avertissements d’incompatibilité de versionExécuter npx expo-doctorÉvaluer les corrections suggérées
Nouveau package ne fonctionne pasRedémarrer le serveurVider le cache Metro
app.json modifiéRedé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 résoudre 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 recherchez — quelqu’un l’a probablement déjà rencontré.

​
Étapes suivantes