zig build em Zig — O que é e Como Usar

Definição

zig build é o comando principal do sistema de build integrado do Zig. Ele compila e executa o arquivo build.zig do projeto para determinar quais artefatos gerar, quais testes rodar e quais dependências resolver. Diferente de ferramentas como Make ou CMake, o sistema de build do Zig é parte da própria toolchain e usa a linguagem Zig para configuração.

Por que zig build Importa

1. Tudo em um: Compilação, testes, instalação e execução em um único sistema.
2. Portável: Funciona identicamente em qualquer plataforma onde Zig está instalado.
3. Cross-compilation: Basta passar -Dtarget= para compilar para outra plataforma.
4. Reprodutível: O mesmo build.zig + build.zig.zon produz o mesmo resultado.

Exemplo Prático

Comandos Básicos

# Compilar o projeto (gera artefatos em zig-out/)
zig build

# Compilar e executar
zig build run

# Executar testes
zig build test

# Listar todos os steps disponíveis
zig build --help

Cross-Compilation

# Compilar para Linux x86_64
zig build -Dtarget=x86_64-linux-gnu

# Compilar para macOS ARM
zig build -Dtarget=aarch64-macos

# Compilar para Windows
zig build -Dtarget=x86_64-windows-gnu

# Build otimizado
zig build -Doptimize=ReleaseFast

build.zig Mínimo para Entender o Fluxo

const std = @import("std");

pub fn build(b: *std.Build) void {
    const target = b.standardTargetOptions(.{});
    const optimize = b.standardOptimizeOption(.{});

    // Step "build" — compilar o executável
    const exe = b.addExecutable(.{
        .name = "app",
        .root_source_file = b.path("src/main.zig"),
        .target = target,
        .optimize = optimize,
    });
    b.installArtifact(exe);

    // Step "run" — executar o programa
    const run = b.addRunArtifact(exe);
    run.step.dependOn(b.getInstallStep());
    if (b.args) |args| {
        run.addArgs(args);
    }
    b.step("run", "Executar o aplicativo").dependOn(&run.step);

    // Step "test" — rodar testes
    const testes = b.addTest(.{
        .root_source_file = b.path("src/main.zig"),
        .target = target,
        .optimize = optimize,
    });
    b.step("test", "Rodar testes").dependOn(&b.addRunArtifact(testes).step);
}

Opções Comuns

Armadilhas Comuns

• Sem build.zig: O comando falha se não houver build.zig no diretório atual ou ancestral.
• Cache agressivo: O Zig faz cache de compilação. Use zig build --summary all para verificar o que foi recompilado.
• Argumentos do programa: Para passar argumentos ao executável, use zig build run -- arg1 arg2.
• Diretório de saída: Artefatos ficam em zig-out/. Este diretório deve estar no .gitignore.

Termos Relacionados

• build.zig — Arquivo de configuração do build
• build.zig.zon — Manifesto de dependências
• zig test — Comando para executar testes
• Cross-Compilation — Compilar para outra plataforma
• Release Modes — Modos de otimização
• Target Triple — Especificação de plataforma

Tutoriais Relacionados

• Zig Build System
• Introdução ao Zig
• Zig para Iniciantes