Files
WalletTracker/TROUBLESHOOTING.md
Arthur Lempereur fc1274b59d Fix: Resolve app loading timeout issues
- Update incompatible dependencies to match Expo SDK 54
- Add metro.config.js with increased timeout
- Temporarily disable react-native-chart-kit to fix loading
- Add placeholder for charts in AnalysisScreen
- Add TROUBLESHOOTING.md guide
- Fix TypeScript error in helpers.ts formatDate function
2025-10-23 15:08:17 +02:00

125 lines
3.2 KiB
Markdown

# 🔧 Guide de dépannage - WalletTracker
## Problème : L'app charge jusqu'au timeout après scan du QR code
### ✅ Solutions appliquées
1. **Mise à jour des dépendances incompatibles**
```bash
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
### 🚀 Relancer l'application
```bash
# Nettoyer le cache
npm start -- --clear
# Ou redémarrer complètement
rm -rf node_modules
npm install
npm start -- --clear
```
### 📱 Vérifications 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)**
```bash
npm start -- --tunnel
```
⚠️ Plus lent mais fonctionne même avec des réseaux différents
### 🔍 Diagnostic
Si le problème persiste, vérifiez :
```bash
# 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 (plus tard)
Une fois l'app fonctionnelle, pour réactiver les graphiques :
1. Installer les dépendances natives :
```bash
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
### 🆘 Autres problèmes courants
#### Erreur "Unable to resolve module"
```bash
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
### 💡 Conseils
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/
## ✅ 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 ! 🎉**