Vous instrumenterez une application en cours d’exécution pour voir ce que fait son cœur réactif : créations de signaux, mutations déclenchant une lecture, demandes de mise à jour, et lancements, complétions et abandons de tâches. quoin-devtools enveloppe le contexte de n’importe quel adaptateur — GPUI, Leptos, Dioxus, Xilem, Floem, ou le contexte testkit.
Prérequis : la fonctionnalité devtools (ou une dépendance directe sur quoin-devtools).
Envelopper le contexte
Section intitulée « Envelopper le contexte »Instrumented::wrap est une enveloppe transparente : continuez d’utiliser le contexte enveloppé partout où vous utilisiez le brut.
use quoin_devtools::Instrumented;
let raw_ctx = /* n'importe quel contexte d'adaptateur */;let ctx = Instrumented::wrap(raw_ctx, "app");Activer l’enregistrement
Section intitulée « Activer l’enregistrement »L’enregistrement est conditionné pour que le câblage n’ait aucun coût en livraison quand il est désactivé — avec le traçage éteint, chaque appel est un simple chargement atomique relâché et rien n’est alloué.
QUOIN_TRACE=1 ./myapp # ou QUOIN_TRACE=onAlternativement, activez-le par programme : quoin_devtools::enable() (et disable() / enabled() pour inspecter l’état).
Lire le journal
Section intitulée « Lire le journal »L’EventLog global est un tampon circulaire (capacité par défaut 4096 événements) avec trois vues agrégées :
quoin_devtools::global_log().dump(); // tableau sur stderrquoin_devtools::global_log().hot_signals(); // comptes de mutations classésquoin_devtools::global_log().events(); // instantané brut des valeurs EventAppelez-les depuis un raccourci de débogage, un panneau déroulant, ou à la sortie. Chaque événement porte un EventKind (mises à jour, lancements, mutations, …) et l’étiquette que vous avez passée à Instrumented::wrap.
Le voir en direct dans une vraie fenêtre
Section intitulée « Le voir en direct dans une vraie fenêtre »L’exemple counter-xilem rend les comptes de trace à côté du compteur et vide la session à la fermeture de la fenêtre :
cargo run --manifest-path examples/counter-xilem/Cargo.tomlPour une visite sans tête de la session de traçage elle-même, exécutez just trace-demo (cela pilote devtools-demo avec QUOIN_TRACE=1).
Transférer vers l’écosystème tracing
Section intitulée « Transférer vers l’écosystème tracing »La fonctionnalité optionnelle tracing transfère les événements dans l’écosystème tracing au lieu de (ou en plus de) le journal intégré.
Étapes suivantes
Section intitulée « Étapes suivantes »-
Référence quoin-devtoolsChaque élément public : Instrumented, EventLog, EventKind et les aides d'enregistrement.
-
Tester avec quoin-testkitTests sans tête déterministes du même code réactif.
