Installatie
Download het Windows x64-archief en pak het uit in een map naar keuze. CrucibleCpp is een statisch gelinkt programma in één bestand, dus u hoeft geen runtime te installeren.
Snel starten
Controleer eerst of PATH de beoogde g++.exe bevat. Vervang daarna gewoon uw bestaande g++ -E:
Als de doel-GCC niet in PATH staat, gebruik --gcc om die expliciet op te geven:
GCC kiezen
CrucibleCpp gebruikt de voorgedefinieerde macro's van de doel-GCC, __has_* data en include-zoekpaden. Gebruik geen GCC15-profiel om GCC14-headers te preprocessen.
| Methode | Gedrag |
|---|---|
--gcc-version=13|14|15 | Zoek in PATH naar de hoogst ondersteunde compiler die bij de hoofdversie past |
--gcc <g++.exe> | Gebruik de opgegeven compiler rechtstreeks en lees de versie en include-paden ervan |
| Niet opgegeven | PATH scannen en standaard de hoogst ondersteunde versie kiezen (15 → 14 → 13) |
--gcc, en vertrouw niet op een vaste schijfletter.Ondersteunde standaardprofielen:
Veelgebruikte commandoregels
| Parameter | Functie |
|---|---|
-P | Geen line markers uitvoeren |
-o <file> | Uitvoerbestand |
-I <dir> | Include-map toevoegen |
-isystem <dir> | Systeemheader-mappen |
-D / -U | Macro's definiëren / ongedefinieerd maken |
-include <file> | Geforceerd opnemen |
-MD -MF -MT | Make/CMake-afhankelijkheidsbestanden genereren |
-finput-charset / -fexec-charset | Invoer- / uitvoeringstekenset |
--embed-dir <dir> | #embed zoekmappen |
--analysis-json <file> | Include-graaf, macro trace en PCH-registraties uitvoeren |
PCH
GCC's g++ -E gebruikt geen .gch; PCH wordt alleen bij het echte compileren gebruikt. Standaard leest CrucibleCpp de headerbronnen en kan het extern gegenereerde PCH's optioneel valideren, registreren en cachen.
PCH-cache inschakelen:
Het cache-manifest registreert het compilerpad, de versie, de compilerhash en de optiehash. PCH's van GCC13/14/15 veroorzaken onderling geen valse cachetreffers.
Diagnostiek
Standaard worden GCC-stijl bronregels en caret weergegeven. U kunt dit uitschakelen of aanpassen:
Ondersteunt #pragma GCC diagnostic push/pop/ignored/warning/error en #pragma GCC system_header. Headers die via -isystem zijn opgenomen, onderdrukken standaard gewone waarschuwingen, en -Wsystem-headers kan ze weer tonen.
Probleemoplossing
Standaardbibliotheekheaders niet gevonden
De doelcompiler staat niet in PATH. Gebruik --gcc om die op te geven, of voeg de map bin toe aan PATH. U kunt ook -isystem gebruiken om die expliciet door te geven.
Verkeerde GCC-versie gekozen
Gebruik --gcc-version=13|14|15 om de hoofdversie vast te zetten, of gebruik --gcc voor een specifieke g++.exe. Meng een doelprofiel niet met headers uit een andere versie.
PCH-cache meldt corrupt
De PCH komt niet overeen met de huidige compiler/opties, of het bestand is beschadigd. Verwijder het bijbehorende cache-item en genereer het opnieuw; u kunt de PCH-cache ook helemaal uitschakelen, zodat de headerbronnen worden gelezen.
GCC kan de uitvoer niet compileren
Controleer eerst of preprocessing en compilatie dezelfde GCC-versie en -std gebruiken. Compileer daarna de ‘.i’ van CrucibleCpp apart, om te controleren of het probleem uit de preprocessingsfase komt.