Blockly utilise des outils et des bibliothèques pour le développement, y compris Git, npm et Closure Compiler. Cette section fournit quelques descriptions de base de chaque outil, ainsi que des liens pour en savoir plus sur chacun d'eux.
Nous utilisons un grand nombre de ces outils par le biais de scripts. Vous n'aurez peut-être jamais besoin de les exécuter directement. Connaître les noms peut toujours être utile pour déboguer ou signaler des problèmes ou demander des fonctionnalités.
Git
Git est un système de contrôle des versions qui nous permet de suivre et de gérer les modifications apportées aux fichiers.
GitHub
GitHub est une plate-forme d'hébergement pour le contrôle des versions, la collaboration et la distribution de code Open Source. Git suit les fichiers. GitHub fournit des interfaces fluides pour examiner le code, suivre les problèmes et afficher l'historique des modifications.
Premiers pas: si vous ne connaissez pas Git et GitHub, suivez les tutoriels de quickstart de GitHub pour vous familiariser avec les principes de base.
Nœud
Node.js est un moyen d'exécuter JavaScript sur le serveur (plutôt que dans un navigateur). npm (voir ci-dessous) s'exécute sur Node.
npm
npm a deux avantages:
- Un outil de ligne de commande que nous utilisons pour installer des dépendances et exécuter des scripts.
- Registre en ligne dans lequel nous publions notre code, ce qui facilite l'utilisation de Blockly par d'autres développeurs.
Premiers pas: Installer Node et npm.
Compilateur de fermeture
Le compilateur de fermeture est un outil permettant d'accélérer le téléchargement et l'exécution de JavaScript. Nous l'utilisons pour combiner tous nos fichiers JavaScript en une seule bibliothèque. Nous l'utilisons également pour vérifier la syntaxe et les types.
Premiers pas : Vous n'avez pas besoin d'installer ni d'exécuter Closure Compiler directement. Nous l'installons et l'exécutons via npm.
En savoir plus: Documentation du compilateur de fermeture sur les types JavaScript et les annotations de type.
ESLint
ESLint est un analyseur statique qui détecte les problèmes liés au code JavaScript. Nous l'utilisons pour définir et appliquer un style cohérent dans notre codebase. Les petits problèmes de code (points-virgules manquants, espacement incohérent, etc.) sont souvent appelés lint. ESLint s'exécute automatiquement lorsque vous nous envoyez une requête d'extraction. Vous pouvez aussi l'exécuter localement.
Premiers pas: dans Blockly Core et blockly-samples, vous pouvez exécuter ESLint avec npm run lint. De nombreux éditeurs de code disposent également d'intégrations ESLint pour afficher les problèmes à mesure que vous saisissez du texte.
En savoir plus: Chaque règle ESLint comporte une page de documentation qui la décrit et donne des exemples de code correct et incorrect.
Moka
Mocha est un framework de test JavaScript. Nous l'utilisons pour exécuter des tests dans le navigateur et sur Node.js (pour les cas d'utilisation sans interface graphique).
Premiers pas: dans Blockly Core et blockly-samples, vous pouvez exécuter nos tests Mocha avec npm run test. D'autres tests seront également exécutés dans Blockly Core.
Les tests Mocha de Blockly Core sont définis dans le répertoire tests/mocha.
En savoir plus: Mocha permet aux développeurs de définir des hooks, qui vous permettent de définir des fonctions de configuration et de suppression centralisées pour vos tests.
Moka
Chai est une bibliothèque d'assertions que nous utilisons dans nos tests Mocha.
En savoir plus: Chai offre plusieurs "types" de syntaxe, pour faciliter l'intégration aux projets existants. Blockly utilise le type assert.