Instalace
Stáhněte archiv pro Windows x64 a rozbalte jej do libovolného adresáře. CrucibleCpp je staticky linkovaný jednosouborový program, takže není nutné instalovat žádné běhové prostředí.
Rychlý start
Nejprve ověřte, že v PATH je cílový g++.exe. Potom jednoduše nahraďte původní g++ -E:
Pokud cílový GCC není v PATH, použijte --gcc a určete jej výslovně:
Volba GCC
CrucibleCpp používá předdefinovaná makra cílového GCC,__has_* data a cesty pro vyhledávání include. Nepoužívejte profil GCC 15 k preprocessingu hlaviček z GCC 14.
| Způsob | Chování |
|---|---|
--gcc-version=13|14|15 | Vyhledá v PATH nejvyšší podporovaný kompilátor odpovídající hlavní verzi |
--gcc <g++.exe> | Použije zadaný kompilátor přímo a načte jeho verzi a include cesty |
| Nezadáno | Prohledá PATH a standardně zvolí nejvyšší podporovanou verzi (15 → 14 → 13) |
--gcc. Nespoléhejte na pevně dané písmeno disku.Podporované standardní profily:
Běžné příkazové řádky
| Parametry | Účel |
|---|---|
-P | Nevypisovat line markers |
-o <file> | Výstupní soubor |
-I <dir> | Přidat adresář include |
-isystem <dir> | Adresáře systémových hlaviček |
-D / -U | Definovat / zrušit makra |
-include <file> | Vynucené zahrnutí |
-MD -MF -MT | Generovat soubory závislostí pro Make/CMake |
-finput-charset / -fexec-charset | Vstupní / prováděcí znaková sada |
--embed-dir <dir> | #embed vyhledávací adresáře |
--analysis-json <file> | Vypíše include graf, macro trace a záznamy PCH |
PCH
Kompilátor GCC g++ -E nepoužívá .gch; PCH se používá až při skutečné kompilaci. CrucibleCpp standardně čte zdrojové texty hlaviček a volitelně validuje, eviduje a cachuje externě vytvořené PCH.
Zapnutí PCH cache:
Manifest cache zaznamenává cestu ke kompilátoru, verzi, hash kompilátoru a hash voleb. PCH z GCC 13/14/15 se vzájemně nepletou.
Diagnostika
Standardně vypisuje zdrojové řádky a caret ve stylu GCC. Lze vypnout nebo upravit:
Podporuje #pragma GCC diagnostic push/pop/ignored/warning/error a #pragma GCC system_header. Hlavičky z -isystem ve výchozím stavu potlačují běžná varování,-Wsystem-headers je dokáže znovu zobrazit.
Řešení problémů
Nelze najít hlavičky standardní knihovny
Cílový kompilátor není v PATH. Zvolte jej pomocí --gcc nebo přidejte jeho bin adresář do PATH. Alternativně pomocí -isystem určete adresář explicitně.
Byla zvolena nesprávná verze GCC
Pomocí --gcc-version=13|14|15 pevně zvolte hlavní verzi, nebo pomocí --gcc odkazujte na konkrétní g++.exe. Nemíchejte cílový profil s hlavičkami jiné verze.
PCH cache hlásí corrupt
PCH neodpovídá aktuálnímu kompilátoru či volbám, případně je soubor poškozený. Smažte odpovídající položku cache a vygenerujte ji znovu; alternativně PCH cache zcela vypněte a nechte jej číst zdrojové texty hlaviček.
Výstup nelze zkompilovat pomocí GCC
Nejprve ověřte, že preprocessing i kompilace používají stejnou verzi GCC a -std. Potom zvlášť zkompilujte „.i vygenerované nástrojem CrucibleCpp“ a zjistěte, zda problém nepochází z fáze preprocessingu.