CMake Quick Start を使用して CMake Hello World プロジェクトを作成する

この記事では、VS Code の CMake Tools 拡張機能を使用して、CMake Hello World プロジェクトをゼロから作成する方法を学習します。

ルートディレクトリに既に CMakeLists.txt ファイルがあるものの、CMake プリセットが存在しない既存の CMake プロジェクトをお持ちの場合は、CMakePresets.json ファイルを作成するセクションまでスキップして、CMake プリセットでプロジェクトを構成してください。

そうでない場合は、新しいプロジェクト用のフォルダーを作成します。ターミナルウィンドウから HelloWorld という名前の空のフォルダーを作成し、そのフォルダーに移動して、以下のコマンドを入力してそのフォルダーで VS Code を開きます。

mkdir helloworld
cd helloworld
code .

code . コマンドは現在の作業フォルダーで VS Code を開き、そのフォルダーが「ワークスペース」となります。

CMakeLists.txt ファイルを作成する

CMake Tools 拡張機能を使用すると、基本的な CMake プロジェクトに必要なファイルを自動的に作成できます。

1. コマンドパレット (⇧⌘P (Windows/Linux の場合は Ctrl+Shift+P)) を開き、CMake: Quick Start コマンドを実行します。

   

2. プロジェクト名を入力し、プロジェクト言語として C++ を選択します。

   この情報は CMakeLists.txt およびいくつかの初期ソースファイルに書き込まれます。

   注意: このフォルダーに CMakeLists.txt のターゲットとして追加したい他のソースコードファイルがある場合は、それらを追加するオプションがここで表示されます。ただし、このチュートリアルでは Hello World ファイルのみを使用します。

3. テストのサポートを追加する追加オプションとして CTest を選択します。CPack のサポートが必要な場合は CPack を選択することもできます。

   

4. 次に、プロジェクトタイプとして Executable を選択し、基本的な main() 関数を含むソースファイル (main.cpp) を作成します。

   

   注意: 基本的なソースファイルとヘッダーファイルを作成したい場合は、代わりに Library を選択します。ただし、このチュートリアルでは Executable で十分です。フォルダーの IntelliSense を構成するように求められた場合は、Allow を選択してください。

これにより CMakeLists.txt ファイルが正常に作成されます。このファイルは、プロジェクトをビルドする方法を CMake ツールに指示します。

CMakePresets.json ファイルを作成する

次に、CMake Quick Start を続けて CMakePresets.json ファイルを作成します。

1. Add a New Preset を選択し、Create from Compilers を選択します。

   拡張機能がコンピューター上のキットを自動的にスキャンし、システム上で見つかったコンパイラのリストを作成します。

2. 使用したいコンパイラを選択します。

   たとえば、インストールされているコンパイラに応じて、以下のような画面が表示されます。

   

3. この新しいプリセットの名前を入力します。

   プリセットの名前は CMakePresets.json に書き込まれます。

これらの手順を完了すると、main.cpp、CMakeLists.txt、CMakePresets.json の各ファイルを含む、完全な Hello World CMake プロジェクトが完成します。