2
Dépannage
Arthur Lempereur edited this page 2025-10-23 18:23:11 +02:00

🔧 Guide de dépannage

Solutions aux problèmes courants de WalletTracker.

📝 Table des matières

  1. L'app ne charge pas / timeout
  2. Erreurs Firebase
  3. Erreurs de modules
  4. Problèmes réseau
  5. Commandes utiles

🔴 L'app ne charge pas / timeout

Solutions

  1. Mise à jour des dépendances incompatibles

    npx expo install --fix
    
  2. Configuration Metro améliorée

    • Ajout de metro.config.js avec timeout augmenté
    • Optimisation du bundler
  3. Graphiques temporairement désactivés

    • react-native-chart-kit peut causer des problèmes de chargement
    • Remplacé par un placeholder dans AnalysisScreen
    • Sera réactivé après configuration complète

Redémarrage complet

# Nettoyer le cache
npm start -- --clear

# Ou redémarrer complètement
rm -rf node_modules
npm install
npm start -- --clear

🌐 Problèmes réseau

  1. Même réseau Wi-Fi

    • Votre ordinateur et téléphone doivent être sur le même réseau
    • Désactivez les VPN si actifs
  2. Pare-feu

    • Autorisez Expo dans votre pare-feu
    • Port 8081 doit être ouvert
  3. Mode tunnel (si problème réseau)

    npm start -- --tunnel
    

    ⚠️ Plus lent mais fonctionne même avec des réseaux différents

Diagnostic réseau

Si le problème persiste, vérifiez :

# 1. Vérifier la connexion
ping 192.168.1.132

# 2. Vérifier que Metro tourne
# Vous devriez voir "Metro waiting on exp://..."

# 3. Tester sur le web d'abord
npm run web

Réactiver les graphiques

Une fois l'app fonctionnelle, pour réactiver les graphiques :

  1. Installer les dépendances natives :

    npx expo install react-native-svg
    
  2. Dans src/screens/AnalysisScreen.tsx :

    • Décommenter import { PieChart } from 'react-native-chart-kit'
    • Remplacer le placeholder par <PieChart ... />
  3. Rebuild l'app

⚠️ Erreurs de modules

Erreur "Unable to resolve module"

npm start -- --clear

Erreur "Network request failed"

  • Vérifiez votre connexion Internet
  • Essayez le mode tunnel : npm start -- --tunnel

L'app crash au démarrage

  • Vérifiez que Firebase est configuré dans src/config/firebase.ts
  • Regardez les logs dans le terminal

"Expo Go" ne trouve pas l'app

  • Assurez-vous que les deux appareils sont sur le même réseau
  • Redémarrez Expo Go
  • Rescannez le QR code

💻 Commandes utiles

  1. Première fois : Utilisez npm start -- --clear pour un démarrage propre
  2. Développement : Le rechargement à chaud peut parfois causer des bugs, rechargez manuellement (secouer le téléphone > Reload)
  3. Production : Les graphiques fonctionneront mieux dans un build natif

🆘 Besoin d'aide ?

Si le problème persiste :

  1. Vérifiez les logs dans le terminal
  2. Regardez les erreurs dans Expo Go (secouer > Show Dev Menu > Debug)
  3. Consultez la documentation Expo : https://docs.expo.dev/

🔥 Erreurs Firebase

Configuration manquante

Si vous voyez l'erreur "Configuration Firebase manquante" :

  1. Vérifiez que le fichier .env existe
  2. Vérifiez que toutes les variables sont remplies
  3. Redémarrez le serveur : npm start -- --clear

Erreurs d'authentification

  • "auth/invalid-email" : Vérifiez le format de l'email
  • "auth/user-not-found" : Créez un compte d'abord
  • "auth/wrong-password" : Vérifiez le mot de passe

Consultez Configuration-Firebase pour plus de détails.


Checklist de vérification

  • Dépendances mises à jour (npx expo install --fix)
  • Cache nettoyé (npm start -- --clear)
  • Même réseau Wi-Fi
  • Pare-feu autorise Expo
  • Firebase configuré (si vous testez l'auth)
  • QR code scanné avec Expo Go (pas l'appareil photo)

L'app devrait maintenant se charger correctement ! 🎉