Como Compilar (Build)
Compilar para Linux
Execute o script a partir da raiz:
bash build/linux/build_linux.sh
Compilar para Windows
A partir do Linux
O script irá verificar e instalar automaticamente o "target" do Rust se necessário:
bash build/linux/build_windows.sh
A partir do Windows (Nativo)
Se estiver a desenvolver diretamente numa máquina Windows, utilize o ficheiro batch. Ele realiza as mesmas tarefas que o script de Linux (compila e copia a DLL), mas utilizando comandos nativos do Windows:
.\build\win\build_windows.bat
Compilar para Web (WASM)
Existem duas formas de compilar para a web. O método via Docker é recomendado, pois gere todas as dependências (Emscripten, Rust na versão fixa em rust-toolchain.toml) automaticamente.
Usando Docker (Recomendado)
Este script compila tanto a versão com threads quanto a versão sem threads:
bash build/linux/build_web_docker.sh
sudo:
sudo usermod -aG docker $USER
# Depois faça logout e login novamente.
Compilação Nativa
Requer Emscripten 4.0.20 instalado no sistema (o Rust é instalado automaticamente na versão fixa em rust-toolchain.toml):
bash build/linux/build_web.sh
Testes automáticos
Os testes correm o núcleo do emulador sem abrir o Godot (não é preciso compilar a extensão nem ter o editor):
cargo test
znake.tap fica carregado na memória.
- TZX (48K e 128K): o znake.tap é convertido para TZX durante o teste e tem de carregar com fastload. Um TZX com bloco turbo tem de tocar em tempo real.
- Turbo load: o detetor de fita a tocar cobre o carregamento todo, desliga-se quando a fita acaba ou pára, e quase não atua com fastload.
- SZX (48K e 128K, com e sem compressão zlib): o mesmo estado carregado por SNA e por SZX corre de forma idêntica, frame a frame.
- SNA: gravar e repor um jogo a correr (é o formato dos save states).
- Todos os jogos da pasta GodotProject/games/: cada ficheiro .tap, .tzx, .sna ou .szx tem de carregar sem erros e mostrar imagem 20 segundos emulados depois de a fita parar. Ficheiros com 128 no nome correm em modo 128K. Para testar um jogo novo basta copiá-lo para essa pasta.
Os testes estão em src/tests.rs.