التثبيت
نزّل أرشيف Windows x64 وفكّ ضغطه في أي دليل. CrucibleCpp برنامج أحادي الملف مرتبط ساكنيًا، لذلك لا حاجة إلى تثبيت وقت تشغيل.
بدء سريع
تأكد أولًا من أن PATH يحتوي على g++.exe. ثم استبدل الأمر g++ -E:
إذا لم تضع GCC الهدف في PATH، فاستخدم --gcc لتحديده صراحةً:
اختيار GCC
يستخدم CrucibleCpp وحدات الماكرو المحددة مسبقًا في GCC الهدف، وبيانات__has_* ومسارات بحث include. لا تستخدم profile الخاص بـ GCC15 لمعالجة رؤوس GCC14 مسبقًا.
| الطريقة | السلوك |
|---|---|
--gcc-version=13|14|15 | البحث في PATH عن أعلى مترجم مدعوم يطابق الإصدار الرئيسي |
--gcc <g++.exe> | استخدام المترجم المحدد مباشرةً وقراءة إصداره ومسارات include |
| بدون تحديد | فحص PATH، مع اختيار أعلى إصدار مدعوم افتراضيًا (15 → 14 → 13) |
--gcc، ولا تعتمد على حرف قرص ثابت.ملفات profile للمعايير المدعومة:
استخدامات سطر الأوامر الشائعة
| المعامل | الوظيفة |
|---|---|
-P | عدم إخراج line markers |
-o <file> | ملف الإخراج |
-I <dir> | إضافة دليل include |
-isystem <dir> | أدلة رؤوس النظام |
-D / -U | تعريف / إلغاء تعريف الماكرو |
-include <file> | تضمين إجباري |
-MD -MF -MT | توليد ملفات تبعية Make/CMake |
-finput-charset / -fexec-charset | مجموعة أحرف الإدخال / التنفيذ |
--embed-dir <dir> | #embed دليل البحث |
--analysis-json <file> | إخراج مخطط include وtrace الماكرو وسجلات PCH |
PCH
أمر GCC g++ -E لا يستخدم ملفات .gch؛ ولا يُستخدم PCH إلا أثناء التجميع الفعلي. ويقرأ CrucibleCpp مصادر الرؤوس افتراضيًا، ويمكنه اختياريًا التحقق من ملفات PCH المولّدة خارجيًا وتسجيلها وتخزينها مؤقتًا.
تفعيل تخزين PCH المؤقت:
يسجّل manifest الخاص بالتخزين المؤقت مسار المترجم وإصداره وhash المترجم وhash الخيارات. ولا تتصادم ملفات PCH الخاصة بـ GCC13/14/15 بعضها مع بعض.
التشخيص
يُخرِج افتراضيًا أسطر مصدر بأسلوب GCC مع caret. يمكن تعطيل ذلك أو تعديله:
يدعم #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. لا تخلط بين target profile ورؤوس إصدار آخر.
التخزين المؤقت لـ PCH يبلّغ عن corrupt
لا يتطابق PCH مع المترجم/الخيارات الحالية، أو أن الملف تالف. احذف إدخال التخزين المؤقت المطابق وأعِد توليده؛ ويمكنك أيضًا إيقاف تخزين PCH المؤقت تمامًا ليقرأ مصادر الرؤوس.
المخرجات لا تُجمَّع بواسطة GCC
تأكد أولًا من أن المعالجة المسبقة والتجميع يستخدمان الإصدار نفسه من GCC و -std. ثم جمّع ملف «.i» الناتج عن CrucibleCpp منفردًا للتأكد مما إذا كانت المشكلة من مرحلة المعالجة المسبقة.