Opções e sinalizadores de compilação
Configure compilações pela linha de comando.
Opções e sinalizadores de compilação é uma aula grátis de Zig Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Zig Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Zig Academy inclui 4 aulas no total.
Configure pela CLI
Uma boa compilação se adapta sem alterações no código. O Zig permite disponibilizar opções que os usuários definem na linha de comando durante a compilação. ⚙️
A opção de otimização
Como você usou standardOptimizeOption, os usuários passam -Doptimize para escolher um modo, como -Doptimize=ReleaseFast para uma compilação rápida.
zig build -Doptimize=ReleaseFastA opção de destino
Da mesma forma, standardTargetOptions lê -Dtarget, permitindo compilar para outra plataforma a partir da sua própria máquina com um único comando.
zig build -Dtarget=x86_64-linuxDefina sua própria opção
Adicione uma sinalização personalizada com b.option. Você informa o tipo, o nome da sinalização e uma descrição de ajuda para os usuários.
const verbose = b.option(bool, "verbose", "Log extra output");As opções são opcionais
b.option retorna um valor opcional: null quando o usuário não o informou. Use orelse para fornecer um valor padrão adequado.
const v = verbose orelse false;Passe-a pela CLI
O usuário define uma opção booleana pelo nome. Assim, -Dverbose=true a ativa, e deixá-la de fora mantém seu valor padrão.
zig build -Dverbose=trueVários tipos de valor
As opções não são apenas booleanas. Você pode declarar inteiros, strings ou enumerações, e o Zig analisa e valida o valor para você.
const n = b.option(u32, "threads", "Worker count");Envie opções para o código
Para que cheguem ao seu programa, crie um módulo de opções com b.addOptions e adicione campos que seu código possa ler em tempo de compilação.
const opts = b.addOptions();Adicione uma constante em tempo de compilação
Coloque um valor nesse módulo com addOption, dando à constante o nome que seu código importará e lerá.
opts.addOption(bool, "verbose", v);Importe opções no código-fonte
Disponibilize o módulo para um artefato com addOptions e, no seu código, faça import dele pelo nome para ler essas constantes.
const config = @import("config");Descubra todas as sinalizações
Todas as opções que você declarar aparecerão em zig build --help, com suas descrições, para que os usuários aprendam a configurar sua compilação. ✅
zig build --helpVerificação rápida
Lembre-se do formato da linha de comando de uma opção de compilação personalizada.
Recapitulação
Você configurou compilações com sinalizações: as opções integradas -Doptimize e -Dtarget, valores personalizados de b.option e addOptions para passar constantes ao seu código. 🎯
Perguntas Frequentes
A aula “Opções e sinalizadores de compilação” é grátis?
Sim — o texto completo de “Opções e sinalizadores de compilação” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Zig Academy, atualize para CoddyKit PRO. O curso de Zig Academy inclui 4 aulas no total.
O que vou aprender em “Opções e sinalizadores de compilação”?
Configure compilações pela linha de comando. Você pratica Zig Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Zig Academy?
Nenhuma experiência prévia é necessária. Zig Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.
Quanto tempo leva a aula “Opções e sinalizadores de compilação”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Zig Academy?
Sim. Cada aula de Zig Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Anatomia de um arquivo build.zig
- Declarando executáveis e bibliotecas
- Etapas de compilação e zig build run
- Opções e sinalizadores de compilação