نصب
بسته Windows x64 را دانلود و در هر دایرکتوری که خواستید استخراج کنید. CrucibleCpp برنامهای تکفایل و لینکشده بهصورت استاتیک است و نیازی به نصب runtime ندارد.
شروع سریع
ابتدا مطمئن شوید که هدف در PATH است: g++.exe. سپس مستقیماً جایگزین g++ -E:
اگر GCC هدف را در PATH نگذاشتهاید، با --gcc صریحاً مشخص کنید:
انتخاب GCC
CrucibleCpp از ماکروهای از پیش تعریفشده GCC هدف، __has_* دادهها و مسیرهای جستوجوی include استفاده میکند. برای پیشپردازش هدرهای GCC14 از پروفایل GCC15 استفاده نکنید.
| روش | رفتار |
|---|---|
--gcc-version=13|14|15 | جستوجو در PATH برای بالاترین کامپایلر پشتیبانیشده با همان نسخه اصلی |
--gcc <g++.exe> | استفاده مستقیم از کامپایلر مشخصشده و خواندن نسخه و مسیرهای include آن |
| بدون تعیین | اسکن PATH با انتخاب پیشفرض بالاترین نسخه پشتیبانیشده (15 → 14 → 13) |
--gccاستفاده کنید و به حرف درایو ثابت وابسته نباشید.پروفایلهای استاندارد پشتیبانیشده:
دستورهای پرکاربرد خط فرمان
| پارامتر | کارکرد |
|---|---|
-P | بدون خروجی line markers |
-o <file> | فایل خروجی |
-I <dir> | افزودن دایرکتوری include |
-isystem <dir> | دایرکتوری هدرهای سیستمی |
-D / -U | تعریف / لغو تعریف ماکرو |
-include <file> | include اجباری |
-MD -MF -MT | تولید فایلهای وابستگی Make/CMake |
-finput-charset / -fexec-charset | مجموعه نویسه ورودی / اجرا |
--embed-dir <dir> | #embed دایرکتوری جستوجو |
--analysis-json <file> | خروجی گراف include، trace ماکرو و رکوردهای PCH |
PCH
دستور g++ -E فایلهای .gchرا به کار نمیبرد؛ PCH فقط هنگام کامپایل واقعی استفاده میشود. CrucibleCpp بهطور پیشفرض سورس هدرها را میخواند و بهصورت اختیاری PCHهای تولیدشده در بیرون را اعتبارسنجی، ثبت و کش میکند.
فعال کردن کش PCH:
manifest کش مسیر کامپایلر، نسخه، هش کامپایلر و hash گزینهها را ثبت میکند. PCHهای GCC13/14/15 بهاشتباه روی هم نمیافتند.
تشخیص
بهطور پیشفرض سطرهای منبع و caret را به سبک GCC خروجی میدهد. میتوان خاموش یا تنظیم کرد:
پشتیبانی از #pragma GCC diagnostic push/pop/ignored/warning/error و #pragma GCC system_header. هدرهای -isystem بهطور پیشفرض هشدارهای معمولی را سرکوب میکنند، -Wsystem-headers میتواند آنها را دوباره نمایش دهد.
عیبیابی
هدرهای کتابخانه استاندارد پیدا نمیشوند
کامپایلر هدف در PATH نیست. با --gcc مشخص کنید، یا bin آن را به PATH اضافه کنید. همچنین میتوانید با -isystem آن را صریحاً پاس دهید.
انتخاب نسخه نادرست GCC
با --gcc-version=13|14|15 نسخه اصلی را ثابت کنید، یا با --gcc اشاره دهید به g++.exe. پروفایل هدف را با هدرهای نسخه دیگر مخلوط نکنید.
کش PCH خطای corrupt میدهد
PCH با کامپایلر/گزینههای فعلی همخوان نیست یا فایل آسیب دیده است. ورودی کش مربوطه را حذف و دوباره تولید کنید؛ میتوانید کش PCH را کاملاً خاموش کنید تا سورس هدرها خوانده شود.
خروجی با GCC کامپایل نمیشود
ابتدا مطمئن شوید که پیشپردازش و کامپایل از یک نسخه GCC و همان -std استفاده میکنند. سپس فایل «.i تولیدشده توسط CrucibleCpp» را جداگانه کامپایل کنید تا ببینید مشکل از مرحله پیشپردازش است یا نه.