Blockly usa algunas herramientas y bibliotecas para el desarrollo, como Git, npm y Closure Compiler. En esta sección, se proporcionan algunas descripciones básicas de cada herramienta, además de vínculos a donde puedes encontrar más información sobre cada una.
Muchas de estas herramientas usamos mediante secuencias de comandos. Es posible que no necesites ejecutarlos directamente. Conocer los nombres aún puede ser útil para depurar o presentar problemas o solicitudes de funciones.
Git
Git es un sistema de control de versión que usamos para realizar un seguimiento de los cambios en los archivos y administrarlos.
GitHub
GitHub es una plataforma de hosting para el control de versiones, la colaboración y la distribución de código abierto. Git hace un seguimiento de los archivos. GitHub proporciona interfaces fluidas para revisar el código, hacer un seguimiento de los problemas y ver el historial de cambios.
Cómo comenzar: Si eres nuevo en Git y GitHub, revisa los instructivos de quickstart de GitHub para familiarizarte con los conceptos básicos.
Nodo
Node.js es una forma de ejecutar JavaScript en el servidor (en lugar de un navegador). npm (ver a continuación) se ejecuta en Node.
npm
npm es dos cosas:
- Una herramienta de línea de comandos que usamos para instalar dependencias y ejecutar secuencias de comandos.
- Un registro en línea en el que publicamos nuestro código, lo que facilita que otros desarrolladores usen Blockly.
Cómo comenzar: Instala Node y npm.
Compilador de cortes viales
El compilador de cierre es una herramienta que permite descargar y ejecutar JavaScript más rápido. Lo usamos para combinar todos los archivos de JavaScript en una sola biblioteca y también para comprobar la sintaxis y los tipos.
Cómo comenzar: No es necesario que instales ni ejecutes Closure Compiler directamente. Lo instalamos y lo ejecutamos a través de npm.
Obtén más información: Documentación del compilador de cierres sobre tipos de JavaScript y anotaciones de tipo.
ESLint
ESLint es un analizador estático que encuentra problemas con el código JavaScript. Lo usamos para definir y aplicar un estilo coherente en toda nuestra base de código. Los pequeños problemas con el código (faltan punto y coma, espaciado incoherente, etc.) suelen llamarse lint. ESLint se ejecuta automáticamente cuando nos envías una solicitud de extracción. También puedes ejecutarlo de forma local.
Cómo comenzar: En el núcleo de Blockly y en las muestras de Blockly, puedes ejecutar ESLint con npm run lint
. Muchos editores de código también tienen integraciones de ESLint para mostrar problemas mientras escribes.
Más información: Cada regla de ESLint tiene una página de documentación en la que se describe la regla y se ofrecen ejemplos de código incorrecto e incorrecto.
Moca
Mocha es un framework de prueba de JavaScript. Lo usamos para ejecutar pruebas en el navegador y en Node.js (para casos de uso sin interfaz gráfica).
Cómo comenzar: En las muestras del núcleo de Blockly y de Blockly, puedes ejecutar nuestras pruebas de Mocha con npm run test
. En el núcleo de Blockly, también se ejecutarán otras pruebas.
Las pruebas Mocha de Blockly Core se definen en el directorio tests/mocha.
Más información: Mocha permite a los desarrolladores definir hooks, que te permiten definir funciones centralizadas de configuración y desmontaje para tus pruebas.
Chai
Chai es una biblioteca de aserciones que usamos en nuestras pruebas de Mocha.
Más información: Chai tiene varias "variantes" de sintaxis para facilitar su integración con proyectos existentes. Blockly usa la variante assert.