CMakeサポート - 機能

CMakeプロジェクト

CMakeプロジェクトを開きます

どんな CMakeに基づいたプロジェクトでも、追加設定の必要なく CLionで簡単に開くことができます

プロジェクトソースのルートCMakeLists.txtファイルを指定するか、
既存の生成フォルダ、またはCMakeCache.txtファイル（Makefilesジェネレータのみで使用可能）を指定します

Mark directory as

ディレクトリをライブラリまたはプロジェクトのソース/ヘッダーとして手動でマークをつける場合、または（CMakeプロジェクト構造とは無関係に）いくつかのディレクトリを除外する場合は、Mark directory as機能を使用して実行できます。これは、インデックス作成（例えば、ビルドディレクトリ、バイナリ、ログ、および生成されたデータをインデックスから除外可能）、コード生成、リファクタリング、およびナビゲーションに影響します。詳細情報。

CLionを検出

プロジェクトのCMakeコマンドがCLionから実行されたことを検出する必要がある場合（そしてそうであれば、特別な変数/パス、または選択した追加のスクリプトを実行する場合） CLION_IDE 環境変数を使用してください。検出を容易にするため、CLionは環境変数を補完します。

ファイルの追加と削除

CLionは、ファイルを追加するとき、CMakeターゲットへの追加を推奨します。

CLionは、プロジェクトからファイルを削除するとき、コマンド引数からファイル参照を削除するか、削除後に不正確なコマンドについて警告します。

プロジェクトのインポート

CMakeでないプロジェクトもインポートできます (File | Import Project...), その場合 CLionはCMakeLists.txtファイルを生成します。

CMakeジェネレータ

CMake File APIをサポートすることで、CLionではさまざまなCMakeジェネレータを有効化できるようになりました。ユーザーはNinja、Xcode、Visual Studioなどを選択できます。この機能はすべてのプラットフォーム、リモートモード、WSLで機能します。

詳細情報

CMake構成

CMakeプロファイル

CMakeプロファイル（Build, Execution, Deployment | CMake）では、CMake生成ディレクトリ、CMake構成タイプ、CMakeオプション、環境変数などを管理できます。

必要な数のCMakeプロファイルをゼロから作成するか、既存のプロファイルをコピーします（すべての設定が事前に入力されています）。プロジェクトのビルド構成を新しい汎用的な CMake プリセットに保存すると、CLion が必要な CMake プリセットを検出して CMake プロファイルにインポートします。

ツールバーの「構成切替を実行」または実行（ Shift+Alt+F10 ）/デバッグ（ Shift + Alt + F9 ）構成切替ポップアップで、CMakeプロファイルを切り替えます。

CMakeツールウィンドウとCMakeキャッシュ

CMakeツールウィンドウには、進捗状況の追跡やCMakeスクリプトのデバッグに使用できるCMakeの出力ログが含まれています。

Settings（設定）| Build, Execution, Deployment（ビルド、実行、デプロイ）| CMake で単一テーブルベースの UI を使用して CMake キャッシュ変数をレビューし、CMake コマンドに渡される CMake オプションを更新できます。

テーブルがフォーカスされている状態で入力を開始すると、変数またはその値を検索できます。 CLion は、CMake キャッシュ変数のツールチップにも短い説明を表示します。

CMakeメニュー

Tools | CMakeに、便利なCMake関連アクションがあります。

Reload CMake Projectを使用して最新のCMakeの変更を適用し、 CLionにプロジェクトを強制的に再読み込みさせることでそれらをエディタに反映できます（自動再読み込みは Build, Execution, Deployment | CMakeで有効にできます)。
Change Project Rootは、プロジェクトルートディレクトリと最上位のCMakeLists.txtがあるディレクトリとが異なる場合に便利です。
Reset Cache and Reload Project を使用すると、IDEのインデックスとキャッシュをすべて削除せずにCMakeキャッシュをクリアできます。

スマートなCMakeサポート

CMakeでの名前変更

RenameリファクタリングShift+F6を使ってCMakeのユーザシンボルの名前を変更すると（関数やマクロなど）、すべての使用箇所は自動的に更新されます。

CMakeインストール

プロジェクトにCMakeのインストールターゲットがある場合は、今すぐCLionの「 Run」メニューから「Install 」を呼び出すことができます。 cmake installコマンドが実行されます。 CLionの任意の構成にInstallのステップを追加することもできます。

CMakeコメント

CLionはCMake 3ブラケット引数とブロックコメント構文に対応しています。 CMakeで行に素早くコメントするには、行を選択する必要はありません。単にキャレットをその上に置いてCtrl+/を押すだけです。ブロックにコメントをするには、ブロックを選択してCtrl+Shift+/を押します。

CMakeLists.txt でのコーディング支援

CLion の CMake ファイルエディターでは、CMakeLists.txt ファイルをより簡単に編集できます。これには以下の内容が含まれます。

CMake フォントと色の設定。
CMake のさまざまなコード領域を展開または折りたたむ機能。
CMake コマンドと変数に対応したコード補完。
CMake にバンドルされたパッケージの find_package に対応したコード補完。
コード補完時の CMake コマンドのドキュメント表示。
CMake 構造ビュー。
CMake で推奨されないコマンドの打ち消し線付きハイライト。

CMakeでのコード生成

CMakeで頻繁に使用されるコード構成、またはカスタムコード構成を作成してライブテンプレートで再利用できます。定義済みのテンプレートから選択するか、独自のテンプレートを作成します。

テンプレートを使用するにはその略語を入力し（ここでも自動補完を使用できます）、Tabキー（または設定したデフォルト以外のキー）を押してテンプレートを展開します。

編集を終了すると、現在のプロジェクトを手動でリロードするか、編集ごとに自動リロードを有効にするかを選択できるバナーが表示されます。

CMake のクイックドキュメント

CMake スクリプトでQuick Documentation（クイックドキュメント）ポップアップを使用できるようになりました。ドキュメントは、次のような標準 CMake エンティティに対して表示されます。

コマンド
ポリシー
モジュール
変数
プロパティ

常に現在バンドルされている CMake バージョンに対するドキュメントが表示されます。現在のところ、ユーザー定義エンティティでは表示されません。

CMake デバッガー

CMake はビルドシステムの言語であるため、CMake スクリプト内のエラーの調査や不審な動作の検出は常に簡単であるとは限りません。 CLion では CMake スクリプトを通常のコードとしてデバッグできます。ブレークポイントの設定、コードのステップ実行、CMake 変数やターゲットのウォッチを行えます。詳細はこちらをご確認ください。

CMake プロファイリング

CLion で、CMake プロジェクトの再ロードに時間がかかっている理由を視覚的に検査することができます。 CMake 3.18 より、CMake 設定でこの新しいトレース機能を有効にできます。 CLion がトレースの実行と結果の可視化を支援します。詳細はこちらをご覧ください。

CMake サポート