CodeCraft

Codecraft

Codecraft é um software de programação gráfica baseado no Scratch 3.0. Destina-se a adolescentes de 7 a 16 anos, compatível com WIN/MAC.
Ao usar uma interface de arrastar e soltar, Codecraft tem ajudado os usuários a programar sem a necessidade de escrever código em linguagens de programação tradicionais baseadas em texto. Desde o seu lançamento em 2018, ele foi projetado para facilitar aos iniciantes, especialmente nas salas de aula STEAM, a adoção da codificação para criar projetos e protótipos. Com foco na programação de microcontroladores e dispositivos IoT, o Codecraft foi adaptado e recebeu a confiança de milhares de usuários em todo o mundo. Em 2022, a Codecraft foi reconhecida como finalista do Bett Awards e finalista do The Edtech Awards Cool Tool, dois importantes e prestigiados prêmios da indústria de tecnologia educacional.

Ajuda on-line do Codecraft

Dispositivos de suporte

• Bosque Zero

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

• micro:bit

• MARCA(CyberEye)

• BRILHO

• Pequeno

• Terminal Wi-Fi

Download

Você pode baixar a versão mais recente na página de download em nosso site ou no Github Release

Pré-requisitos

Este projeto requer:

• Node.js 16+
• Python 2.x ou Python 3.x e torná-lo a versão padrão

Instalação automática

Linux/Mac:

bash run-mac.sh

Windows:

bash run-win64.sh

Instalação 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 ou linux como

npm run build-mac

• Para vencer

npm run build-win

Construir aplicativo 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 Windows

npm run publish-win64

Depois de terminar a construção, você pode encontrar o instalador em main/build/

Modo de depuração

Se você deseja entrar no modo de depuração e depurar a interface gráfica, primeiro você precisa executar a interface gráfica localmente. A interface gráfica depende do bloco, l10n e vm, então você precisa compilar esses três projetos primeiro.

 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

Neste momento, um serviço web está sendo executado no terminal atual. host local:8601

Em seguida, modifique o URL de carregamento da janela.

Linha 213 em /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 ();

Abra um novo terminal

 cd ./main
npm run start

Adicionar bloco e biblioteca

forma de bloco e definição de tipo

diretório de bloco: blocos/blocks_vertical

diretório l10n do bloco: blocos/msg/scratch_msgs.js

O valor do tipo de bloco deve começar com 'argumento', 'cor', 'controle', 'dados', 'evento', 'aparência', 'matemática', 'movimento', 'operador', 'procedimentos', 'detecção' , 'som', 'sistema', 'display', 'azure', 'json', 'mqtt'. esses valores são definidos em CORE_EXTENSIONS dos arquivos vm/src/serialization/sb2.js e sb3.js

definição de código de bloco

diretório de código: gui/src/lib/generators/${device}/

bloquear renderização da interface do usuário

diretório ui xml: 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

diretório da biblioteca: main/compilers/arduino-libraries/

Você pode colocar sua biblioteca do Arduino neste diretório

Contribuir

PR welcome

Aqui, também adoraríamos anunciar uma chamada aberta para contribuições para o projeto de código aberto Codecraft no GitHub. Quer você seja um programador experiente ou esteja apenas começando, agradecemos contribuições de todos os níveis. Desde a correção de bugs até a implementação de novos recursos e novos blocos de funções, para torná-lo compatível com mais plataformas de hardware, até melhorar a base de código geral, há muitas maneiras pelas quais você pode contribuir para o projeto. Agradecemos antecipadamente pelo seu interesse em contribuir para este projeto!

Licença

O código contido neste repositório e as distribuições executáveis ​​são licenciados sob os termos da Licença Apache 2.0. As distribuições executáveis ​​contêm código de terceiros licenciado sob outras licenças compatíveis, como BSD-3.

TODO: adicione documentação sobre como criar novos módulos