Skip to content

Instalacao e Compilacao

PedroVMota edited this page Nov 13, 2026 · 2 revisions

Instalação e compilação

O bitwerk ainda não tem binários publicados: compila-se a partir do código-fonte.

Requisitos

Requisito Detalhe
Sistema macOS com Metal. O assets/Info.plist declara LSMinimumSystemVersion 11.0.
Rust Canal stable, fixado em rust-toolchain.toml (componentes clippy e rustfmt). Edição 2024, rust-version = "1.85".
Ferramentas opcionais cargo-deny (auditoria), cargo-fuzz + toolchain nightly (fuzzing), iconutil (vem com o macOS, só para regenerar o ícone).

O renderizador exige wgpu sobre Metal; a aplicação recusa arrancar sem ele ("bitwerk requires the wgpu (Metal) renderer"). O menu nativo só existe em macOS; noutras plataformas a barra egui mostra Open/Save, mas o alvo do projeto é o macOS.

Alvos do Makefile

make help lista todos. Resumo:

Alvo Comando Para quê
build cargo build --workspace Build de depuração de todo o workspace.
release cargo build --workspace --release Build otimizado (LTO thin, codegen-units = 1, overflow-checks = true, panic = "abort").
run cargo run -p bw-app Corre a aplicação (depuração).
test cargo test --workspace Todos os testes.
lint cargo clippy --workspace --all-targets -- -D warnings Clippy (pedantic) com avisos como erros.
fmt / fmt-check cargo fmt --all [-- --check] Formatação.
audit cargo deny check Advisories, licenças, bans e fontes (requer cargo-deny).
fuzz cargo +nightly fuzz run … Os cinco alvos de fuzzing, 5 minutos cada.
fuzz-check cargo check --manifest-path fuzz/Cargo.toml Só compila o crate de fuzzing (em stable).
bench cargo test --release -p bw-render --test gpu_smoke -- --ignored --nocapture Medição headless do custo por frame com 100k objetos.
sweep cargo run --release -p bw-app -- --stress --sweep Medição automática de ≈20 s na app (abre uma janela).
icon binário bw-icon + iconutil Redesenha o ícone a partir do código.
bundle release + cópia de ficheiros Cria target/bitwerk.app.
check-all fmt-check lint test audit Todas as verificações.
clean cargo clean Limpa os artefactos.

Compilar e correr

git clone <url-do-repositório> bitwerk
cd bitwerk
make run                 # depuração
# ou
make release
./target/release/bitwerk examples/half-adder.bitwerk

O executável chama-se bitwerk (crate bw-app). Todas as opções estão em Linha de comandos.

Bundle .app

make bundle
open target/bitwerk.app

O alvo cria target/bitwerk.app com:

  • Contents/MacOS/bitwerk — o binário release;
  • Contents/Info.plist — copiado de assets/Info.plist;
  • Contents/Resources/AppIcon.icns — o ícone.

O bundle não é assinado nem notarizado pelo Makefile.

Ícone

O ícone (uma porta NAND com uma entrada a 1, outra a 0 e a saída acesa, sobre uma grelha) é desenhado por código a partir da mesma geometria dos símbolos (bw_render::symbols::raster::app_icon, rasterizador simples com supersampling 4×4). make icon corre o binário bw-icon, que escreve os PNG do .iconset e assets/AppIcon-256.png, e o iconutil gera assets/AppIcon.icns. Os dois ficheiros já estão no repositório, por isso um build normal não precisa deste passo. O PNG de 256 px vai embutido no executável (include_bytes!) e define o ícone da janela e do Dock.

Nada é descarregado da rede em nenhum destes passos (além das dependências do Cargo).

Registo (logging)

A aplicação usa tracing. O filtro por omissão é info,wgpu_core=warn,wgpu_hal=warn; pode ser mudado com a variável RUST_LOG, por exemplo:

RUST_LOG=debug ./target/release/bitwerk

Ver também

Clone this wiki locally