Contribuye con Core

El repositorio principal de Blockly contiene el código necesario para ejecutar cualquier aplicación basada en Blockly.

Información que debes saber

A continuación, se incluye una descripción general rápida de los hechos sobre el núcleo bloqueador que debes conocer para crear una RR.PP.

  • La rama de trabajo está desarrollada y todas las RR.PP. deben hacerse en función del desarrollo.
  • Debes completar la plantilla de solicitud de extracción con la información solicitada.
  • El código debe cumplir con la Guía de estilo de TypeScript de Google.
  • Usa confirmaciones convencionales en tus mensajes de confirmación y títulos de solicitudes de extracción.
  • Las cadenas visibles para el usuario deben estar en el archivo /msg/messages.js para que se puedan traducir. Menos del 6% del mundo habla inglés de forma nativa.
  • El texto de los bloques suele estar escrito en minúsculas (al igual que las palabras clave en la mayoría de los lenguajes de programación).
  • Mantener la retrocompatibilidad. Hay muchas apps de Blockly en el mercado. Eso no afecta a todos los demás.

  • Todos los archivos de código nuevos deben tener el prefijo de la licencia Apache v2.0:

    /**
 *   @license
 *   Copyright <Current YYYY> Google LLC
 *   SPDX-License-Identifier: Apache-2.0
 */

Cómo realizar y verificar un cambio

  1. Ejecuta npm install para instalar las dependencias.
  2. Ejecuta npm run start para iniciar un servidor que ejecute la zona de pruebas. Puedes usar esta página para probar el comportamiento existente. Consulta la página de playground para obtener más información.
  3. Realiza los cambios necesarios en el código.
  4. Si dejaste el servidor ejecutándose, actualiza la página para ver los cambios. De lo contrario, reinicia el servidor y verifica que el código se comporte como se espera y que no haya errores ni advertencias en la consola.
  5. Ejecuta npm run build y asegúrate de que no haya errores de compilación.
  6. Escribe pruebas automatizadas. Por lo general, serán pruebas Mocha en el directorio tests/mocha, pero es posible que te solicitemos otros tipos de pruebas.
  7. Ejecuta npm run format para dar formato al código y solucionar automáticamente algunos problemas de lint.
  8. Ejecuta npm test para ejecutar las pruebas automatizadas. Esto también ejecuta eslint.
  9. Si hay errores de lint, ejecuta npm run lint:fix para solucionar los problemas que se pueden corregir automáticamente. Soluciona cualquier advertencia o error de lint restante.
  10. Si se superan todas las pruebas, tienes todo listo para iniciar una solicitud de extracción con el desarrollo con los cambios.