インストール
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
GCC の g++ -E は使いません。除外対象は .gch。PCH は実際のコンパイル時にのみ使用されます。CrucibleCpp はデフォルトでヘッダーのソースを読み取り、必要に応じて外部で生成された PCH を検証、登録、キャッシュします。
PCH キャッシュを有効にする:
キャッシュの manifest にはコンパイラのパス、バージョン、コンパイラのハッシュ、オプションのハッシュが記録されます。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」を単独でコンパイルし、問題がプリプロセス段階に由来するか確認します。