Débogage et DevTools Flutter

Cette section présentera les outils de débogage de Flutter et les techniques de débogage courantes.


Introduction à Flutter DevTools

Flutter DevTools est une suite d'outils pour déboguer et analyser les applications Flutter.

Lancer DevTools

$ flutter run

Après avoir exécuté l'application, le terminal affichera l'URL de DevTools, généralementhttp://127.0.0.1:9100

Commandes courantes

CommandeDescription
flutter doctorVérifier la configuration de l'environnement de développement
flutter analyzeAnalyse statique du code
flutter testExécuter les tests

print et debugPrint

Exemple : sortie de débogage de base

// Impression de base
print('Hello Debug');  // Sortie vers la console

// debugPrint évite la troncature des longs textes
debugPrint('Ceci est un long texte qui peut être affiché en entier sans être tronqué');

// Impression conditionnelle
if (debugMode) {
  print('Infos de débogage');
}

// Afficher un objet (nécessite toString)
final user = {'name': 'Zhang San', 'age': 25};
print('Informations utilisateur : $user');  // Sortie : Informations utilisateur : {name: John Doe, age: 25}

Assertion - assert

Les assertions sont utilisées pour vérifier des conditions pendant le développement et ne prennent effet qu’en mode débogage.

< h2 class="example">Exemple d’utilisation des assertions
// Assertion simple
assert(user != null, 'L’utilisateur ne peut pas être vide');

// Validation des paramètres de fonction
void setAge(int age) {
  // L’âge doit être supérieur à 0
  assert(age > 0, 'L’âge doit être supérieur à 0');
  this.age = age;
}

// Assertions dans la construction de l’interface utilisateur (développement uniquement)
Widget build(BuildContext context) {
  // S’assurer que le contexte n’est pas null
  assert(context != null);
  // S'assurer qu'il existe un Scaffold parent
  assert(debugCheckHasMaterial(context));
  return Scaffold(...);
}

Débogage avec points d'arrêt

Définissez des points d'arrêt dans VS Code ou Android Studio pour le débogage.

Débogage dans VS Code

  1. Cliquez sur le côté gauche du numéro de ligne pour définir un point d'arrêt
  2. Appuyez sur F5 ou cliquez sur le bouton de débogage pour démarrer le débogage
  3. Utilisez la barre d'outils de débogage pour contrôler l'exécution du programme

Commandes courantes des points d'arrêt

OpérationDescription
Continuer / F5Continuer l'exécution jusqu'au point d'arrêt suivant
Pas à pas principal / F10Pas à pas principal, sans entrer dans les fonctions
Pas à pas détaillé / F11Pas à pas détaillé, en entrant dans les fonctions
Pas à pas sortant / Maj+F11Sortir de la fonction actuelle

Inspecteur Flutter

L'inspecteur Flutter fait partie de DevTools, utilisé pour visualiser et inspecter l'arborescence des widgets.

Fonctionnalités principales

  • Arborescence des widgets: Afficher la structure hiérarchique des widgets
  • Explorateur de mise en page: Vérifier les contraintes de mise en page
  • Superposition des performances: Afficher les métriques de performance

Débogage des problèmes courants

Exemple : Débogage de l'interface utilisateur qui ne se met pas à jour

// Problème : l'interface utilisateur ne se met pas à jour
// Raison : setState n'a pas été appelé après la modification de l'état

// Exemple incorrect
void _increment() {
  _counter++;  // L'état a changé, mais l'interface utilisateur ne se mettra pas à jour !
}

// Exemple correct
void _increment() {
  setState(() {
    _counter++;  // Il faut appeler setState
  });
}

// Problème : la gestion d'état est désordonnée
// Suggestion : utilisez Provider ou une autre solution de gestion d'état

Outils courants pour le débogage : print pour afficher les journaux, Inspector pour inspecter l'arborescence des Widgets, et Timeline pour analyser les performances.

autres extensions