Documentation

Kezdje az első paranccsal

Ez az oldal a telepítést, a cél-GCC kiválasztását, a gyakori parancssorokat, a PCH-t, a diagnosztikát és a hibaelhárítást tárgyalja. A teljes implementáció és a tesztmátrix hiteles forrása a GitHub-tárház.

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.

cruciblecpp-preprocessor.exe --version # cruciblecpp-preprocessor 3.0.1
Jelenlegi produkciós cél: Windows x64 + MinGW-w64 UCRT64. Más platformok, ABI-k és GCC-verziók támogatását nem garantáljuk.

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:

# Előfeldolgozás .\cruciblecpp-preprocessor.exe -P -std=c++20 src\main.cpp -o build\main.i # Fordítás ugyanazzal a GCC-vel g++ -std=c++20 build\main.i -o build\main.exe

Ha a cél-GCC nincs a PATH-ban, használja a --gcc kapcsolót a kifejezett megadásához:

.\cruciblecpp-preprocessor.exe ` --gcc "D:\GCC1413\gcc14\bin\g++.exe" ` -P -std=c++20 src\main.cpp -o build\main.i

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ódViselkedés
--gcc-version=13|14|15A 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 megadvaVégigpásztázza a PATH-t, és alapértelmezésben a legmagasabb támogatott verziót választja (15 → 14 → 13)
Az automatikus felderítés csak a PATH-t pásztázza. Ha máshová telepítette, adja hozzá a PATH-hoz, vagy használja a --gcc-t, és ne hagyatkozzon rögzített meghajtóbetűjelre.

Támogatott szabványprofilok:

-std=c++11 C++11 profile -std=c++14 C++14 profile -std=c++17 C++17 profile -std=c++20 C++20 profile

Gyakori parancssorok

ParaméterekRendeltetés
-PNe 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 / -UMakrók definiálása / törlése
-include <file>Kényszerített include
-MD -MF -MTMake/CMake függőségi fájlok generálása
-finput-charset / -fexec-charsetBemeneti / 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.

# Figyelmeztetés .gch fájl észlelésekor --pch=warn # Azonnali hiba .gch fájl észlelésekor --pch=error # A figyelmen kívül hagyott PCH-k rögzítése az analysis JSON-ban --pch=report

PCH-gyorsítótár engedélyezése:

.\cruciblecpp-preprocessor.exe ` --pch-cache .cache\pch ` --pch-cache-stats .cache\pch\stats.json ` -P src\main.cpp -o build\main.i

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ó:

-fdiagnostics-color=auto|always|never -fno-diagnostics-show-caret -fno-diagnostics-show-option -Werror -Wno-error=name --max-errors 20

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.

A CrucibleCpp előfeldolgozó, nem fordító. Nem foglalkozik kódgenerálással, optimalizálással, linkeléssel és a GCC bináris PCH belső formátumának elemzésével.