CLion 2024.1 ヘルプ

CMake プロジェクトを作成する / 開く

CMake プロジェクトを最初から作成する

  1. ウェルカム画面で新しいプロジェクトをクリックするか、メインメニューからファイル | 新しいプロジェクトを選択します。

  2. 左側のペインで C++ 実行ファイルを選択します。プロジェクト名と言語標準を設定します。

    Creating a new CMake project
  3. 作成をクリックします。

  4. CLion は、次のコマンドを含む単一のソースファイル main.cpp とルート CMakeLists.txt を含むスタブプロジェクトを生成します。

    CMakeLists.txt in a stub CMake project

    コマンド

    説明

    cmake_minimum_required(VERSION 3.24)

    CMake の最低限必要なバージョンを指定(英語)します。CLion にバンドルされている CMake のバージョンに設定されています(常に利用可能な最新バージョンの 1 つ)。

    project(cmake_testapp)

    プロジェクト作成時に指定した内容に従ってプロジェクト名を定義します。

    set(CMAKE_CXX_STANDARD 17)

    プロジェクトの作成時に選択したように、CMAKE_CXX_STANDARD 変数を 17 の値に設定(英語)します。

    add_executable(cmake_testapp main.cpp)

    main.cpp からビルドされる cmake_testapp 実行可能ターゲットを追加(英語)します。

  5. CMake ツールウィンドウには、プロジェクトの読み込みの進行状況とステータスが表示されます。表示 | ツールウィンドウ | CMake からいつでもアクセスするか、下部のナビゲーションバーで切り替えることができます。

    CMake tool window

ソースから CMake プロジェクトを作成する

CLion では、非 CMake プロジェクトを開き、その構造を CMake に変換できます。

  1. ウェルカム画面で開くをクリックするか、メインメニューからファイル | 開くを選択します。

  2. プロジェクトのルートフォルダーを選択し、開くをクリックします。

    Opening a non-CMake project folder
  3. エディターで任意のソースファイルを開きます。上部に黄色の通知が表示されます。

    Project not configured notification

    CMake プロジェクトの構成をクリックして CMakeLists.txt を作成しますを選択します。

    Create CMakeLists.txt
  4. 開いたダイアログで、次を指定します。

    • プロジェクトファイルを選択

      プロジェクトファイルとしてインポートするファイルを選択します。サブディレクトリのチェックボックスを使用してコンテンツ全体をインポートするか、チェックボックスをオフにしてコンテンツを選択的にインポートします。

    • ユーザーインクルードディレクトリ

      プロジェクトに含めるディレクトリを選択し、CMake の include_directories(英語) コマンドで指定します。

      プロジェクトファイルを選択で選択されていないディレクトリは、ユーザーインクルードディレクトリリストに表示されません。最初に選択すると、利用可能なインクルードディレクトリがリストに表示されます。

      Create CMakeLists.txt dialog
  5. OK をクリックすると、CLion は選択に従って CMakeLists.txt ファイルを生成し、CMake プロジェクト構造をロードします。

    CMakeLists.txt generated

CMake プロジェクトを開く

CLion で既存の CMake プロジェクトを開くには、次のいずれかを実行します。

  • ファイル | 開くを選択してプロジェクトディレクトリを見つけます。このディレクトリには CMakeLists.txt ファイルが含まれています。

  • ファイル | 開くを選択し、CLion を最上位の CMakeLists.txt ファイルにポイントします (または CMakeCache.txt ファイルを見つけます)。

    次にプロジェクトとして開くをクリックします。

    Opening CMakeLists.txt as project

プロジェクトを初めて開くと、CLion は初期構成の CMake プロファイルダイアログを表示します。プロファイルを編集するか、デフォルト設定で続行できます。

Default CMake profile settings

この初期プロファイル構成を無効にするには、設定 | 詳細設定に移動し、対応するチェックボックスをオフにします。

Initial CMake profile configuration setting

monorepo を使用する

Monorepos は、通常は最上位の CMake スクリプトなしで、複数のプロジェクトを組み合わせるリポジトリです。以下の手順では、LLVM プロジェクト(英語)を例として使用して、CLion でモノレポを操作する方法について説明します。

  1. ファイル | 開くを呼び出し、CLion を必要なサブディレクトリの CMakeLists.txt にポイントします。LLVM の場合は、llvm-project/llvm/CMakeLists.txt を選択します。

    開いたダイアログで、プロジェクトとして開くをクリックします。

  2. プロジェクトを開くウィザードCMake のオプションフィールドに、ビルドするサブプロジェクトを追加します。

    例: clangclang-tools-extra を追加するには、次のように指定します

    -DLLVM_ENABLE_PROJECTS="clang;clang-tools-extra"
    Compiler flags for LLVM subprojects

    この時点でプロジェクトの読み込みは正常に実行されるはずです。

  3. プロジェクトツリーでリポジトリ全体を表示できるようにするには、プロジェクトルートを変更します。メインメニューからツール | CMake | プロジェクトルートを変更するを呼び出し、最上位のリポジトリフォルダー llvm-project を選択します。

  4. プロジェクトをビルドすることもお勧めします。このように、resolve は、ビルド時に生成されたパーツを含むコードベース全体で機能します。

関連ページ:

CMakeLists.txt

CMakeLists.txt ファイルには、プロジェクトのソースファイルとターゲット(実行可能ファイル、ライブラリ、その両方)を記述する指示文と命令のセットが含まれています。新しいプロジェクトを作成すると、CLion は自動的に CMakeLists.txt ファイルを生成してプロジェクトのルートディレクトリに配置します。プロジェクトを開くには、CLion を最上位の CMakeLists.txt にポイントしてプロジェクトとして開くを選択します。以下の例は、単純な「Hello, World」プロジェクト...

ファイルテンプレート

ファイルテンプレートは、プロジェクトツリーのコンテキストメニューのメニューまたは新規セクションを使用して作成する新しいファイルの既定の内容の仕様です。作成するファイルの種類に応じて、テンプレートは、その種類のすべてのファイルに期待される初期コードとフォーマットを提供します (業界または言語の標準、企業ポリシー、その他の理由に従って)。CLion は、新しいファイルを作成するときに提案される、サポートされているすべてのファイルタイプの定義済みテンプレートを提供します。推奨されるファイルタイプのセッ...

CMake プロファイル

CMake プロジェクトのビルドに必要な設定は CMake プロファイルに組み込まれています。これには、ツールチェーンとビルド型に加え、ジェネレーターや環境変数などの CMake オプションが含まれます。たとえば、異なるコンパイラーを使用したり、異なる設定でターゲットをビルドしたりするために、プロジェクトに複数のプロファイルを構成できます。プロファイル設定にアクセスする次のいずれかを実行して、CMake プロファイル設定を開きます。に移動します。を押してアクションの検索ダイアログを開き、CMake...

ビルドアクション

プロジェクトのビルド、クリーニング、インストールのアクションは、メインメニューのビルドセクションにまとめられています。以下の表は、ビルドアクションが次のタイプのプロジェクトでどのように機能するかを示しています。CMake,、メイクファイル、中間子、カスタムビルドターゲットを含む Compilation Database とカスタム実行 / デバッグ構成。CMake プロジェクトのビルドアクション:プロジェクトのビルドカスタムビルドターゲットの場合: 最初のターゲットのビルドツールを呼び出します。ビ...

CMake インストール

ワークフローにプロジェクトのインストールが含まれている場合は、インストールルールを生成する CMake インストールコマンドを使用できます。インストールの構成インストールコマンドを CMakeLists.txt ファイルに配置します。install コマンドの [DESTINATION dir] フィールドを使用して、インストールパスを設定します。ここには 2 つのオプションがあります。完全なパスにスラッシュまたはドライブ文字を入力します。ダイアログのセクションで提供されている場合は、相対パスを使用します。...

CMake の読み込み / 再読み込み

CMake をロードするプロジェクトルートで CMakeLists.txt ファイルが検出されると、CLion はそのファイルを自動的に読み込みます。CMakeLists.txt ファイルを手動でロードするには、プロジェクトツリーでファイルを右クリックし、コンテキストメニューから CMake プロジェクトを読み込むを選択します。CMakeLists.txt の変更時に CMake を再ロードするデフォルトでは、CMakeLists.txt ファイルに変更を加えると、CLion は、プロジェクトを再ロードす...