Instalasi
Unduh arsip Windows x64 dan ekstrak ke direktori mana saja. CrucibleCpp adalah program satu berkas dengan linking statis, jadi tidak perlu memasang runtime.
Mulai cepat
Pertama, pastikan PATH memuat g++.exe. Lalu cukup ganti g++ -E:
Jika GCC target tidak ada di PATH, gunakan --gcc untuk menentukannya secara eksplisit:
Memilih GCC
CrucibleCpp memakai makro bawaan GCC target, __has_* data dan jalur pencarian include. Jangan memakai profil GCC15 untuk mempraproses header GCC14.
| Cara | Perilaku |
|---|---|
--gcc-version=13|14|15 | Mencari compiler tertinggi yang didukung di PATH dengan versi utama yang cocok |
--gcc <g++.exe> | Memakai compiler yang ditentukan secara langsung dan membaca versi serta jalur include-nya |
| Tidak ditentukan | Pindai PATH, secara default pilih versi tertinggi yang didukung (15 → 14 → 13) |
--gcc, dan jangan bergantung pada huruf drive tetap.Profil standar yang didukung:
Baris perintah umum
| Parameter | Fungsi |
|---|---|
-P | Tidak mengeluarkan line markers |
-o <file> | Berkas keluaran |
-I <dir> | Tambahkan direktori include |
-isystem <dir> | Direktori header sistem |
-D / -U | Mendefinisikan / membatalkan makro |
-include <file> | Penyertaan paksa |
-MD -MF -MT | Hasilkan berkas dependensi Make/CMake |
-finput-charset / -fexec-charset | Set karakter masukan / eksekusi |
--embed-dir <dir> | #embed direktori pencarian |
--analysis-json <file> | Menghasilkan graf include, macro trace, dan catatan PCH |
PCH
Mode g++ -E milik GCC tidak memakai .gch; PCH hanya dipakai saat kompilasi sebenarnya. Secara default CrucibleCpp membaca sumber header, dan secara opsional dapat memvalidasi, mencatat, serta menyimpan dalam cache PCH yang dihasilkan secara eksternal.
Aktifkan cache PCH:
Manifest cache mencatat jalur compiler, versi, hash compiler, dan hash opsi. PCH dari GCC13/14/15 tidak saling bertabrakan.
Diagnostik
Secara default menghasilkan baris sumber dan caret bergaya GCC. Anda dapat mematikan atau menyesuaikannya:
Mendukung #pragma GCC diagnostic push/pop/ignored/warning/error dan #pragma GCC system_header. Header yang berasal dari -isystem secara default menekan peringatan biasa, -Wsystem-headers dapat menampilkannya kembali.
Pemecahan masalah
Header pustaka standar tidak ditemukan
Compiler target tidak ada di PATH. Gunakan --gcc untuk menentukannya, atau tambahkan direktori bin ke PATH. Anda juga dapat menggunakan -isystem untuk meneruskannya secara eksplisit.
Versi GCC yang dipilih salah
Gunakan --gcc-version=13|14|15 untuk mematok versi utama, atau gunakan --gcc untuk menunjuk berkas g++.exe. Jangan mencampur profil target dengan header dari versi lain.
Cache PCH melaporkan corrupt
PCH tidak cocok dengan compiler/opsi saat ini, atau berkasnya rusak. Hapus entri cache yang sesuai lalu buat ulang; sebagai alternatif, matikan sepenuhnya cache PCH dan biarkan ia membaca sumber header.
Keluaran tidak dapat dikompilasi GCC
Pertama, pastikan praproses dan kompilasi memakai versi GCC yang sama dan -std. Lalu kompilasi “.i hasil CrucibleCpp” secara terpisah untuk memastikan apakah masalah berasal dari tahap praproses.