Telepítés
Töltse le a Windows x64 archívumot, és bontsa ki bármelyik könyvtárba. A CrucibleCpp statikusan linkelt, egyfájlos program, ezért nem kell futtatókörnyezetet telepíteni.
Első lépések
Először ellenőrizze, hogy a PATH tartalmazza a cél g++.exe. Ezután egyszerűen cserélje le a meglévő g++ -E:
Ha a cél-GCC nincs a PATH-ban, használja a --gcc kapcsolót a kifejezett megadásához:
GCC kiválasztása
A CrucibleCpp a cél-GCC előre definiált makróit,__has_* adatait és include-keresési útvonalait használja. Ne a GCC15 profiljával dolgozza fel a GCC14 fejlécfájljait.
| Mód | Viselkedés |
|---|---|
--gcc-version=13|14|15 | A PATH-ban keresi a legmagasabb támogatott, a főverzióhoz illeszkedő fordítót |
--gcc <g++.exe> | Közvetlenül a megadott fordítót használja, és beolvassa annak verzióját és include-útvonalait |
| Nincs megadva | Végigpásztázza a PATH-t, és alapértelmezésben a legmagasabb támogatott verziót választja (15 → 14 → 13) |
--gcc-t, és ne hagyatkozzon rögzített meghajtóbetűjelre.Támogatott szabványprofilok:
Gyakori parancssorok
| Paraméterek | Rendeltetés |
|---|---|
-P | Ne adjon ki line markereket |
-o <file> | Kimeneti fájl |
-I <dir> | include-könyvtár hozzáadása |
-isystem <dir> | Rendszerfejléc-könyvtárak |
-D / -U | Makrók definiálása / törlése |
-include <file> | Kényszerített include |
-MD -MF -MT | Make/CMake függőségi fájlok generálása |
-finput-charset / -fexec-charset | Bemeneti / végrehajtási karakterkészlet |
--embed-dir <dir> | #embed keresési könyvtárai |
--analysis-json <file> | include-gráf, makró-nyomkövetés és PCH-rekordok kiírása |
PCH
A GCC g++ -E nem használja a .gch-t; a PCH csak a tényleges fordításkor használatos. A CrucibleCpp alapértelmezésben a fejlécfájlok forrását olvassa, és opcionálisan ellenőrizheti, nyilvántarthatja és gyorsítótárazhatja a külsőleg előállított PCH-kat.
PCH-gyorsítótár engedélyezése:
A gyorsítótár manifestje rögzíti a fordító útvonalát, verzióját, a fordító hashét és a beállítások hashét. A GCC13/14/15 PCH-jai nem ütköznek egymással.
Diagnosztika
Alapértelmezésben GCC-stílusú forrássorokat és caretet ír ki. Ez kikapcsolható vagy módosítható:
Támogatja a #pragma GCC diagnostic push/pop/ignored/warning/error és a #pragma GCC system_header. Az -isystem által include-olt fejlécek alapértelmezésben elnyomják a szokásos figyelmeztetéseket, a-Wsystem-headers pedig újra meg tudja jeleníteni őket.
Hibaelhárítás
A szabványos könyvtár fejlécfájljai nem találhatók
A célfordító nincs a PATH-ban. Használja a --gcc kapcsolót a megadásához, vagy adja hozzá a bin könyvtárát a PATH-hoz. A -isystem kapcsolóval kifejezetten is átadhatja.
Rossz GCC-verziót választott
Használja a --gcc-version=13|14|15 kapcsolót a főverzió rögzítéséhez, vagy a --gcc kapcsolót egy konkrét g++.exe. Ne keverje össze a célprofilt egy másik verzió fejlécfájljaival.
A PCH-gyorsítótár corrupt állapotot jelez
A PCH nem illeszkedik az aktuális fordítóhoz/beállításokhoz, vagy a fájl sérült. Törölje a megfelelő gyorsítótár-bejegyzést, majd generálja újra; a PCH-gyorsítótárat teljesen ki is kapcsolhatja, ilyenkor a fejlécfájlok forrásából dolgozik.
A kimenetet a GCC nem tudja lefordítani
Először győződjön meg arról, hogy az előfeldolgozás és a fordítás ugyanazt a GCC-verziót és -std kapcsolót használja. Ezután a „CrucibleCpp által előállított .i” fájlt külön fordítsa le, hogy megállapítsa, a probléma az előfeldolgozási fázisból ered-e.