Repository navigation
Instalacao e Compilacao
O bitwerk ainda não tem binários publicados: compila-se a partir do código-fonte.
| 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.
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. |
git clone <url-do-repositório> bitwerk
cd bitwerk
make run # depuração
# ou
make release
./target/release/bitwerk examples/half-adder.bitwerkO executável chama-se bitwerk (crate bw-app). Todas as opções estão em Linha de comandos.
make bundle
open target/bitwerk.appO alvo cria target/bitwerk.app com:
-
Contents/MacOS/bitwerk— o binário release; -
Contents/Info.plist— copiado deassets/Info.plist; -
Contents/Resources/AppIcon.icns— o ícone.
O bundle não é assinado nem notarizado pelo Makefile.
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).
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/bitwerkbitwerk — simulador de circuitos lógicos digitais para macOS · Licença MIT OR Apache-2.0 (LICENSE-MIT e LICENSE-APACHE no repositório) · A fonte de verdade é o código e o README.md do repositório; esta wiki descreve a versão 0.1.0.
Começar
Utilização
- Componentes
- Fios e junções
- Simulação
- Memória
- Macros e hierarquia
- Parts Centre
- Importação do Digital Works
- Exportação para o Digital Works
Referência técnica
Projeto