12,964
回編集
「CMake - インクルード」の版間の差分
ナビゲーションに移動
検索に移動
→set(CMAKE_INCLUDE_CURRENT_DIR ON)
| 180行目: | 180行目: | ||
== set(CMAKE_INCLUDE_CURRENT_DIR ON) == | == set(CMAKE_INCLUDE_CURRENT_DIR ON) == | ||
CMakeのビルド設定において、<br> | |||
現在のディレクトリ (CMakeLists.txtファイルが存在するディレクトリ) とビルドディレクトリを自動的にインクルードパスに追加するオプションである。<br> | |||
<br> | <br> | ||
<u>CMake変数<code>CMAKE_INCLUDE_CURRENT_DIR</code>をONに指定することにより、以下に示す2つのディレクトリが自動的にインクルードパスに追加される。</u><br> | <u>CMake変数<code>CMAKE_INCLUDE_CURRENT_DIR</code>をONに指定することにより、以下に示す2つのディレクトリが自動的にインクルードパスに追加される。</u><br> | ||
* 現在のソースディレクトリ ( | * 現在のソースディレクトリ (CMakeLists.txtファイルが存在するディレクトリ) の自動追加 | ||
* | *: 現在処理中のソースディレクトリが、インクルードパスに追加する。 | ||
* 現在のビルドディレクトリの自動追加 | |||
*: CMakeによって生成されたファイル (例: 設定ファイルや自動生成されたヘッダファイル等) が配置されるビルドディレクトリをインクルードパスに追加する。 | |||
<br> | <br> | ||
この変数を有効にする場合、以下に示すような特徴がある。<br> | |||
そのため、開発者は明示的に<code>include_directories</code>コマンドで指定する必要がない。 | * 利便性の向上 | ||
*: ソースファイル内でヘッダファイルをインクルードする時に、フルパスを指定する必要がなくなる。 | |||
* 自動生成ファイルの取り扱い | |||
*: 特に、CMakeやQtのような自動生成ツールによって生成されるファイルを簡単にインクルードできるようになる。 | |||
*: そのため、開発者は明示的に<code>include_directories</code>コマンドで指定する必要がない。 | |||
* サブディレクトリへの影響 | |||
*: この設定は、現在のディレクトリとそのサブディレクトリに対して有効になる。 | |||
<br> | <br> | ||
この変数を有効にする場合、以下に示すようなメリットがある。<br> | |||
* Qtプロジェクトで、moc (Meta-Object Compiler) によって生成されたファイルを容易に見つけることができる。 | |||
* CMakeのconfigure_fileコマンドで生成されたヘッダファイルを簡単にインクルードすることができる。 | |||
<br> | |||
ただし、大規模なプロジェクトでは不要なディレクトリもインクルードパスに追加される可能性があるため、明示的にインクルードディレクトリを指定する方が管理しやすい。<br> | |||
また、同名のヘッダファイルが異なるディレクトリに存在する場合、予期せぬ衝突が発生する可能性がある。<br> | |||
<br> | |||
そのため、大規模なプロジェクトや複雑なディレクトリ構造を持つプロジェクトでは、<br> | |||
より明示的なインクルードパスの管理 (<code>target_include_directories</code>コマンドの使用等) を検討すること推奨する。<br> | |||
<br><br> | <br><br> | ||