Documentation

İlk komutla başlayın

Bu sayfa kurulumu, hedef GCC seçimini, sık kullanılan komut satırlarını, PCH'yi, tanıları ve sorun gidermeyi kapsar. Tam uygulama ve test matrisi için GitHub deposu esas alınır.

Kurulum

Windows x64 arşivini indirin, herhangi bir dizine çıkarmanız yeterli. CrucibleCpp statik bağlanmış tek dosyalık bir programdır; çalışma zamanı kurulumu gerektirmez.

cruciblecpp-preprocessor.exe --version # cruciblecpp-preprocessor 3.0.1
Mevcut üretim hedefi: Windows x64 + MinGW-w64 UCRT64. Diğer platformlar, ABI'ler ve GCC sürümleri için destek taahhüt edilmez.

Hızlı başlangıç

Önce PATH içinde hedef g++.exe dosyasının bulunduğunu doğrulayın. Ardından doğrudan mevcut g++ -E:

# Ön işleme .\cruciblecpp-preprocessor.exe -P -std=c++20 src\main.cpp -o build\main.i # Aynı GCC ile derle g++ -std=c++20 build\main.i -o build\main.exe

Hedef GCC PATH içinde değilse, --gcc ile açıkça belirtin:

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

GCC seçimi

CrucibleCpp hedef GCC'nin önceden tanımlı makrolarını,__has_* verilerini ve include arama yollarını kullanır. GCC15 profilini GCC14 başlık dosyalarını ön işlemek için kullanmayın.

YöntemDavranış
--gcc-version=13|14|15PATH içinde ana sürümle eşleşen en yüksek desteklenen derleyiciyi arar
--gcc <g++.exe>Belirtilen derleyiciyi doğrudan kullanır; sürümünü ve include yollarını okur
BelirtilmemişPATH'i tarar, varsayılan olarak en yüksek desteklenen sürümü seçer (15 → 14 → 13)
Otomatik algılama yalnızca PATH'i tarar. Başka bir dizine kurulduysa onu PATH'e ekleyin veya şunu kullanın --gcc, sabit bir sürücü harfine güvenmeyin.

Desteklenen standart profiller:

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

Sık kullanılan komut satırları

ParametreEtkisi
-PLine marker çıktısı yok
-o <file>Çıktı dosyası
-I <dir>include dizini ekle
-isystem <dir>Sistem başlık dizini
-D / -UMakro tanımla / kaldır
-include <file>Zorunlu include
-MD -MF -MTMake/CMake bağımlılık dosyaları üret
-finput-charset / -fexec-charsetGiriş / yürütme karakter kümesi
--embed-dir <dir>#embed arama dizini
--analysis-json <file>include grafiği, makro trace ve PCH kayıtlarını üret

PCH

GCC'nin g++ -E komutu .gch kullanmaz; PCH yalnızca gerçek derleme sırasında kullanılır. CrucibleCpp varsayılan olarak başlık dosyası kaynaklarını okur ve harici üretilen PCH'leri isteğe bağlı olarak doğrular, kaydeder ve önbelleğe alır.

# .gch bulunduğunda uyarı ver --pch=warn # .gch bulunduğunda doğrudan hata ver --pch=error # Yoksayılan PCH'leri analysis JSON içinde kaydet --pch=report

PCH önbelleğini etkinleştirme:

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

Önbellek manifest dosyası derleyici yolunu, sürümünü, derleyici karmasını ve seçenek hash'ini kaydeder. GCC13/14/15 PCH'leri birbirleriyle yanlış eşleşmez.

Tanılar

Varsayılan olarak GCC tarzı kaynak satırları ve caret çıktılar. Kapatılabilir veya ayarlanabilir:

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

Şunlar desteklenir: #pragma GCC diagnostic push/pop/ignored/warning/error ve #pragma GCC system_header. -isystem ile gelen başlıklar normal uyarıları varsayılan olarak bastırır; -Wsystem-headers bunları yeniden görünür kılar.

Sorun giderme

Standart kütüphane başlık dosyası bulunamıyor

Hedef derleyici PATH içinde değil. --gcc ile belirtin veya bin dizinini PATH'e ekleyin. Alternatif olarak -isystem ile açıkça geçirebilirsiniz.

Yanlış GCC sürümü seçildi

Ana sürümü --gcc-version=13|14|15 ile sabitleyin veya --gcc ile belirli bir g++.exe dosyasını gösterin. Hedef profili başka bir sürümün başlık dosyalarıyla karıştırmayın.

PCH önbelleği corrupt bildiriyor

PCH mevcut derleyici/seçeneklerle uyuşmuyor veya dosya bozuk. İlgili önbellek girdisini silip yeniden oluşturun; PCH önbelleğini tamamen kapatıp başlık dosyası kaynaklarından okumasını da sağlayabilirsiniz.

Çıktı GCC ile derlenemiyor

Önce ön işleme ile derlemenin aynı GCC sürümünü ve -std seçeneğini kullandığını doğrulayın. Ardından “CrucibleCpp'nin ürettiği .i” dosyasını tek başına derleyerek sorunun ön işleme aşamasından gelip gelmediğini kontrol edin.

CrucibleCpp bir ön işlemcidir, derleyici değildir. Kod üretimi, optimizasyon, bağlama ve GCC'nin ikili PCH iç biçimini ayrıştırmadan sorumlu değildir.