Outils de debug

Vue d'ensemble

Voir chaque requête, mutation et entrée de cache de l'application en cours d'exécution, et agir dessus, depuis un panneau intégré à l'application.

L'outil de debug de Qora est l'overlay intégré : un panneau affiché dans votre application en cours d'exécution, en build debug uniquement. Il montre ce que contient le cache, ce que fait chaque requête, et chaque mutation avec ses variables et son contexte de rollback, en temps réel.

Overlay intégré

Installez-le, enveloppez l'application avec QoraInspector, et touchez le bouton Q. Fonctionne sur simulateurs, émulateurs et appareils physiques.

Ce que vous pouvez voir et faire

Zone	Contenu
Requêtes	Chaque clé en cache avec son statut, avec recherche. L'inspecteur montre la donnée en cache et la machine à états, avec des actions : Refetch, Invalidate, Mark Stale, Remove, Simulate Error
Mutations	Mutations en cours et terminées. L'inspecteur montre les variables, le résultat ou l'erreur, et le contexte de rollback renvoyé par `onMutate`, avec Retry et Cancel
Timeline	Fetchs, mutations, mises à jour optimistes et vidages du cache, dans l'ordre
Data Diff	Pour une mutation : les variables envoyées face au résultat du serveur, et le snapshot du cache pris pour une mise à jour optimiste

Les actions nécessitent de passer le client à QoraInspector ; sans lui, l'overlay est en lecture seule.

Fonctionnement

QoraClient rapporte ce qu'il fait à un QoraTracker. L'overlay en fournit un, OverlayTracker, qui garde les événements récents en mémoire (200 par canal) pour que le panneau les affiche.

QoraClient
    │
    ├── NoOpTracker     par défaut, et en release : aucun événement, aucun coût
    └── OverlayTracker  builds debug : événements gardés en mémoire pour le panneau

En build release, vous passez null comme tracker : le client utilise NoOpTracker, et QoraInspector ne construit rien. Voir Sécurité en production.

Pour envoyer les mêmes événements à plusieurs trackers (l'overlay et votre propre journalisation, par exemple), combinez-les avec MultiTracker de qora.

Extension IDE

Une extension Flutter DevTools est en développement et n'est pas publiée. L'overlay est l'outil supporté ; cette page renverra vers l'extension quand elle sortira.

Étapes suivantes

Overlay intégré : installation et configuration
Sérialisation des données : rendre vos modèles lisibles dans l'inspecteur

Éditer cette pageouSignaler un problème

Requête infinie

Référence complète de InfiniteData, InfiniteQueryState, InfiniteQueryOptions, InfiniteQueryObserver, InfiniteQueryBuilder, InfiniteQueryController et les méthodes de requête infinie de QoraClient.

Overlay intégré

Un panneau de débogage flottant rendu à l'intérieur de l'app Flutter. Inspectez les requêtes, mutations et mises à jour optimistes sans outil externe.