انسٹالیشن
Windows x64 کا آرکائیو ڈاؤن لوڈ کریں اور کسی بھی ڈائریکٹری میں ایکسٹریکٹ کر لیں۔ CrucibleCpp اسٹیٹک لنک شدہ سنگل فائل پروگرام ہے، اسے رن ٹائم انسٹال کرنے کی ضرورت نہیں۔
فوری آغاز
پہلے PATH میں ہدف کا پتہ لگائیں: g++.exe۔ پھر براہِ راست پرانے g++ -E:
اگر ہدف GCC کو PATH میں نہیں رکھا، تو --gcc سے واضح طور پر بتائیں:
GCC کا انتخاب
CrucibleCpp ہدف GCC کے پیش طے شدہ میکرو،__has_* ڈیٹا اور include کے تلاش کے راستے استعمال کرتا ہے۔ GCC15 کا پروفائل GCC14 کے ہیڈرز کی پیش پردازش کے لیے استعمال نہ کریں۔
| طریقہ | رویہ |
|---|---|
--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
GCC کا g++ -E کمانڈ .gch فائلوں کو استعمال نہیں کرتا؛ PCH صرف اصل کمپائل کے وقت استعمال ہوتا ہے۔ CrucibleCpp بطورِ ڈیفالٹ ہیڈر فائلوں کا سورس پڑھتا ہے اور اختیاری طور پر بیرونی طور پر بنائے گئے PCH کی تصدیق، رجسٹریشن اور کیشنگ کرتا ہے۔
PCH کیش فعال کریں:
کیش manifest کمپائلر کا پاتھ، ورژن، کمپائلر ہیش اور آپشنز کا hash ریکارڈ کرتا ہے۔ GCC13/14/15 کے PCH ایک دوسرے سے غلط طریقے سے نہیں ٹکراتے۔
تشخیص
بطورِ ڈیفالٹ 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۔ پھر «CrucibleCpp سے بنی .i» کو الگ سے کمپائل کریں تاکہ معلوم ہو کہ مسئلہ پیش پردازش کے مرحلے سے ہے یا نہیں۔