התקנה
הורידו את הארכיון של 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> | הכללה כפויה |
-MD -MF -MT | יצירת קובצי תלות Make/CMake |
-finput-charset / -fexec-charset | ערכת תווים לקלט / להרצה |
--embed-dir <dir> | #embed ספריית חיפוש |
--analysis-json <file> | פלט של גרף include, macro trace ורישומי PCH |
PCH
הכלי g++ -E לא יעשה שימוש בקובצי .gch; קובצי PCH משמשים רק בהידור בפועל. CrucibleCpp קורא כברירת מחדל את קובצי הכותרת ממקור, ובאופן אופציונלי מאמת, רושם ומטמון קובצי PCH שנוצרו חיצונית.
הפעלת מטמון PCH:
ה-manifest של המטמון מתעד נתיב קומפיילר, גרסה, גיבוב של הקומפיילר ו-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 עם קובצי כותרת של גרסה אחרת.
מטמון PCH מדווח corrupt
ה-PCH אינו תואם לקומפיילר או לאפשרויות הנוכחיות, או שהקובץ פגום. מחקו את רשומת המטמון המתאימה וצרו אותה מחדש; אפשר גם לכבות את מטמון ה-PCH כדי שייקראו קובצי הכותרת ממקור.
הפלט אינו ניתן להידור על ידי GCC
תחילה מוודאים שהעיבוד המקדים וההידור משתמשים באותה גרסת GCC ובאפשרות -std. לאחר מכן קמפלו בנפרד את קובץ ה-.i שנוצר על ידי CrucibleCpp, כדי לבדוק אם הבעיה מגיעה משלב העיבוד המקדים.