CodeCraft

Codecraft

Codecraft es un software de programación gráfica basado en Scratch 3.0. Está dirigido a adolescentes de 7 a 16 años, compatible con WIN/MAC.
Al utilizar una interfaz de arrastrar y soltar, Codecraft ha ayudado a los usuarios a programar sin la necesidad de escribir código en lenguajes de programación tradicionales basados ​​en texto. Desde su lanzamiento en 2018, está diseñado para facilitar que los principiantes, especialmente en las aulas STEAM, adopten la codificación para crear proyectos y prototipos. Centrándose en la programación de microcontroladores y dispositivos IoT, Codecraft ha sido adaptado y cuenta con la confianza de miles de usuarios en todo el mundo. En 2022, Codecraft fue reconocido como finalista de los premios Bett Awards y finalista de Cool Tool de los premios Edtech, dos premios importantes y prestigiosos de la industria de la tecnología educativa.

Ayuda de Codecraft en línea

Dispositivos de soporte

• Arboleda cero

• Arduino Mega && Arduino Uno && Grove Kit para principiantes para Arduinol

• micro:bit

• MARCA (CyberEye)

• DESTELLO

• poco

• Terminal Wio

Descargar

Puede descargar la última versión desde la página de descarga de nuestro sitio web o Github Release

Requisitos previos

Este proyecto requiere:

• Nodo.js 16+
• Python 2.x o Python 3.x y convertirlo en la versión predeterminada

Instalación automática

Linux/Mac:

bash run-mac.sh

Ventanas:

bash run-win64.sh

Instalación manual

 cd ./blocks
npm install && npm run build

cd ./l10n
npm install && npm run build

cd ./vm
npm install && npm run build

cd ./gui
npm install

• Para mac o linux como

npm run build-mac

• para ganar

npm run build-win

Construir aplicación principal

rm -r ../main/app/gui && cp -r ./build ../main/app/gui
cd ./main/app
npm install
./node_modules/.bin/electron-rebuild serialport

# If the error message “script is prohibited on this system” appears on the Windows   
# system, you need to open powershell as an administrator, and then execute 
# Set-ExecutionPolicy RemoteSigned

cd ./main
npm install
rm -r build 

• Para Mac

npm run publish-mac

• Para Linux como

npm run publish-linux

• Para ventanas

npm run publish-win64

Una vez que termine de compilar, puede encontrar el instalador en main/build/

Modo de depuración

Si desea ingresar al modo de depuración y depurar la interfaz gráfica de usuario, primero debe ejecutar la interfaz gráfica de usuario localmente. La interfaz gráfica de usuario depende de block, l10n y vm, por lo que primero debes compilar estos tres proyectos.

 cd ./blocks
npm install && npm run build

cd ./l10n
npm install && npm run build

cd ./vm
npm install && npm run build

cd ./gui
npm run start

En este momento, se está ejecutando un servicio web en la terminal actual. servidor local: 8601

Luego modifique la URL de carga de la ventana.

Línea 213 en /main/src/application.js

Comment out the line.
window.loadURL(loadURL) ;

Open the line.
window.loadURL( ' http://localhost:8601 ' ) ;

If you need the console, open the line.
window.webContents.openDevTools ();

Abrir una nueva terminal

 cd ./main
npm run start

Agregar bloque y biblioteca

definición de forma y tipo de bloque

directorio de bloques: bloques/bloques_vertical

bloquear directorio l10n: bloques/msg/scratch_msgs.js

El valor del tipo de bloque debe comenzar con 'argumento', 'color', 'control', 'datos', 'evento', 'aspectos', 'matemáticas', 'movimiento', 'operador', 'procedimientos', 'detección' , 'sonido', 'sistema', 'pantalla', 'azure', 'json', 'mqtt'. estos valores están definidos en CORE_EXTENSIONS de los archivos vm/src/serialization/sb2.js y sb3.js

definición de código de bloque

directorio de códigos: gui/src/lib/generators/${device}/

bloquear la representación de la interfaz de usuario

directorio xml de interfaz de usuario: gui/lib/toolboxs/toolbox-${deviceId}-xml.js

1001: grove zero
1002: arduino
1004: micro:bit
1005: mark
1006: grove joint
1007: mPython
1008: glint
1009: bittle
1010: wio terminal

biblioteca arduino

directorio de biblioteca: principal/compiladores/arduino-libraries/

Puedes poner tu biblioteca arduino en este directorio.

Contribuir

PR welcome

Aquí también nos encantaría anunciar una convocatoria abierta para contribuciones al proyecto de código abierto Codecraft en GitHub. Ya sea que sea un programador experimentado o recién esté comenzando, agradecemos las contribuciones de todos los niveles. Desde corregir errores hasta implementar nuevas características y nuevos bloques de funciones, hacerlo compatible con más plataformas de hardware y mejorar el código base general, hay muchas maneras en las que puedes contribuir al proyecto. ¡Gracias de antemano por su interés en contribuir a este proyecto!

Licencia

El código contenido en este repositorio y las distribuciones ejecutables están licenciados según los términos de la Licencia Apache 2.0. Las distribuciones ejecutables contienen código de terceros con licencia de otras licencias compatibles, como BSD-3.

TODO: agregar documentación sobre cómo crear nuevos módulos