Instalação
Baixe o pacote do Windows x64 e descompacte em qualquer diretório. O CrucibleCpp é um programa de arquivo único vinculado estaticamente, então não é preciso instalar runtime.
Início rápido
Primeiro, confirme se o PATH contém o g++.exe. Depois, basta substituir o seu g++ -E:
Se o GCC de destino não estiver no PATH, use --gcc para especificá-lo explicitamente:
Seleção do GCC
O CrucibleCpp usa as macros predefinidas do GCC de destino, os dados de __has_* e os caminhos de busca de include. Não use um perfil do GCC 15 para pré-processar cabeçalhos do GCC 14.
| Modo | Comportamento |
|---|---|
--gcc-version=13|14|15 | Procura no PATH o compilador mais alto suportado que corresponda à versão principal |
--gcc <g++.exe> | Usa diretamente o compilador especificado e lê sua versão e seus caminhos de include |
| Não especificado | Varre o PATH e escolhe por padrão a versão mais alta suportada (15 → 14 → 13) |
--gcc, e não dependa de uma letra de unidade fixa.Perfis de padrão suportados:
Linhas de comando comuns
| Parâmetro | Função |
|---|---|
-P | Não emitir line markers |
-o <file> | Arquivo de saída |
-I <dir> | Adicionar diretório de include |
-isystem <dir> | Diretórios de cabeçalhos do sistema |
-D / -U | Definir / indefinir macros |
-include <file> | Inclusão forçada |
-MD -MF -MT | Gerar arquivos de dependência do Make/CMake |
-finput-charset / -fexec-charset | Conjunto de caracteres de entrada / execução |
--embed-dir <dir> | #embed diretórios de busca |
--analysis-json <file> | Gerar grafo de include, macro trace e registros de PCH |
PCH
O g++ -E do GCC não usa .gch; o PCH só é usado na compilação real. Por padrão, o CrucibleCpp lê os cabeçalhos-fonte e, opcionalmente, valida, registra e armazena em cache PCHs gerados externamente.
Ativar o cache de PCH:
O manifesto do cache registra o caminho do compilador, a versão, o hash do compilador e o hash das opções. Os PCHs de GCC13/14/15 não colidem entre si.
Diagnósticos
Por padrão, emite linhas de código-fonte e caret no estilo GCC. Você pode desativar ou ajustar:
Suporta #pragma GCC diagnostic push/pop/ignored/warning/error e #pragma GCC system_header. Cabeçalhos provenientes de -isystem suprimem avisos comuns por padrão, e -Wsystem-headers pode exibi-los novamente.
Solução de problemas
Cabeçalhos da biblioteca padrão não encontrados
O compilador de destino não está no PATH. Use --gcc para especificá-lo, ou adicione seu diretório bin ao PATH. Você também pode usar -isystem para passá-lo explicitamente.
Versão errada do GCC selecionada
Use --gcc-version=13|14|15 para fixar a versão principal, ou use --gcc para apontar para o g++.exe. Não misture um perfil de destino com cabeçalhos de outra versão.
O cache de PCH acusa corrupt
O PCH não corresponde ao compilador/opções atuais, ou o arquivo está corrompido. Exclua a entrada de cache correspondente e regenere; alternativamente, desative o cache de PCH e deixe-o ler os cabeçalhos-fonte.
A saída não compila no GCC
Primeiro, confirme se o pré-processamento e a compilação usam a mesma versão do GCC e o mesmo -std. Em seguida, compile separadamente o “.i gerado pelo CrucibleCpp” para confirmar se o problema vem da etapa de pré-processamento.