用 CMake 快速入门创建 CMake hello world 项目

在本文中,你将学习如何使用 VS Code 中的 CMake 工具扩展从零创建 CMake hello world 项目。

如果你有一个已有的CMake项目,并且已经有CMakeLists.txt文件在根目录中,但没有CMake预设,你可以跳到那里创建一个CMakePresets.json文件用CMake预设配置你的项目。

否则,可以为新项目创建一个文件夹。从终端窗口创建一个名为的空文件夹HelloWorld进入该文件夹,输入以下命令打开 VS Code:

mkdir helloworld
cd helloworld
code .

代码。命令在当前工作文件夹中打开 VS Code,这个文件夹就成为你的“工作区”。

创建一个CMakeLists.txt文件

CMake 工具扩展可以帮你创建基础的 CMake 项目文件。

  1. 打开命令面板(⇧⌘P(Windows,Linux Ctrl+Shift+P),并运行 CMake: 快速启动命令:

    创建CMake快速入门

  2. 输入项目名称,选择 C++ 作为项目语言。

    这些信息将被书面写给CMakeLists.txt以及一些初始源文件。

    注:如果你在这个文件夹里有其他源代码文件,想作为目标添加到CmakeLists.txt现在提供了添加这些选项。但在这个教程中,我们只用 hello world 文件。

  3. 选择CTest作为添加测试支持的额外选项。您也可以选择 CPack 以获得 CPack 支持。

    附加选项

  4. 接下来,选择可执行文件作为项目类型以创建基本源文件(main.cpp)包含一个基本main()功能。

    选择项目类型

    注:如果你想创建一个基础的源头文件和头文件,你会选择。但在这个教程里,Executable可以。如果提示你为该文件夹配置IntelliSense,请选择允许

这成功地生成了CMakeLists.txt文件,告诉CMake工具如何构建你的项目。

项目内容

创建一个CMakePresets.json文件

接下来,继续使用 CMake 快速入门创建CMakePresets.json档案。

  1. 选择添加新预设从编译器创建

    该扩展会自动扫描你电脑上的套件,并生成系统中编译器的列表。

  2. 选择你想使用的编译器。

    例如,根据你安装的编译器,你可能会看到这样的情况:

    添加一个新的预设

  3. 请输入这个新预设的名字。

    预设的名称将写为CMakePresets.json.

完成这些步骤后,你现在应该拥有一个完整的hello world CMake项目,其中包含以下文件:main.cpp,CMakeLists.txt, 和CMakePresets.json.

添加一个新的预设