Ce document décrit le script npm run convert-rduino, qui transforme une sauvegarde Blockly@rduino (XML / .B@) en workspace JSON chargeable dans µcBlockly.
npm run convert-rduino -- <fichier-entree> [fichier-sortie.json]
Exemple :
npm run convert-rduino -- chemin/vers/projet.xml out/workspace.json
Exemple (si le dépôt voisin Blockly@rduino est présent, comme pour les tests) :
npm run convert-rduino -- ../Blockly-at-rduino/examples/blink/blink.xml out/workspace.json
.xml, .B@ ou tout export XML Blockly@rduino (« enregistrer projet »).workspace.json par défaut si le second argument est omis).| Cas | Traitement |
|---|---|
| Blocs Arduino de base | Mappés vers les types µcBlockly via scripts/lib/rduino-block-map.mjs |
Blocs « définitions » orange (base_define_bloc) | Dépliés en blocs racine |
Piles sans setup / loop | Enveloppées dans board_base_setup_loop (corps loop) sauf si UCB_NO_WRAP=1 |
| Extensions (Grove, mBot, TechnoZone, …) | Conservées sous leur nom d’origine si non mappées — peuvent ne pas charger ; voir unmappedBlockTypes dans la sortie |
UCB_NO_WRAP=1 npm run convert-rduino -- projet.xml out.json
Ne pas envelopper les blocs orphelins dans setup/loop.
| Fichier | Rôle |
|---|---|
scripts/convert-rduino-workspace.mjs | Point d’entrée CLI |
scripts/lib/rduino-block-map.mjs | Table de correspondance des types de blocs |
scripts/lib/rduino-xml-to-ucb-json.mjs | Parsing XML → JSON workspace |
tests/rduino-convert.test.ts | Tests (blink, analogique, Starter_Kit_prj7) |