CMake入门（Visual Studio Code + VS2019）

本入门练习参考CMake官网（https://cmake.org/cmake/help/latest/guide/tutorial/index.html）中的Step 1： A Basic Starting Point

本入门练习的系统是windows10，已安装Visual Studio Code 和 viusal studio 2019（c++）

///

第一步：在自己的工作目录下如：（ E:/TEMP ）新建一个项目文件夹如：（ tutorial ）

///

第二步：在项目文件夹内，新建如下3个文件：

1. 文本文件：CMakeLists.txt，代码如下：

cmake_minimum_required(VERSION 3.10)

# set the project name and version
project(tutorial VERSION 1.0)

# specify the C++ standard
set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED True)

# add the executable
add_executable(tutorial tutorial.cxx)

代码做了如下事情：

# 设置项目的名称是“tutorial”，版本是1.0；

# 指定项目使用的C++11标准；

# 设置项目输出的可执行文件名为“tutorial”(也可以是其它例如：mytutorial)，对应的源码文件是“tutorial.cxx"

2. 源代码文件：tutorial.cxx，代码如下：

//#include <cstdlib>
#include "TutorialConfig.h"
#include <iostream>   // std::cout
#include <string>     // std::stod
int main(int argc, char** argv) {
	const double inputValue = std::stod(argv[1]);
	if (argc < 4) {
		// report version
		std::cout << argv[0] << " Version " << Tutorial_VERSION_MAJOR << "."
			<< Tutorial_VERSION_MINOR << std::endl;
		std::cout << "Usage: " << argv[0] << "("<<inputValue<<")" << std::endl;
		return 1;
	}
}

代码主要做的事情是：

如果输入的参数小于4个，则输出程序名称及版本号，并输出可执行程序名及输入的第2个参数

否则什么都不做

3. 头文件TutorialConfig.h，代码如下：

// the configured options and settings for Tutorial
#define Tutorial_VERSION_MAJOR "1.0"
#define Tutorial_VERSION_MINOR "0"

代码定义了程序的大、小版本号

///

第三步：运行Visual Studio Code

1. 加载项目文件夹：

File——OPen Folder...

在弹出的对话框中选择项目文件夹E:\TEMP\tutorial，界面如下：

2. 选择编译器：

如图，点击1处界面下方的工具栏；弹出2处选择框后，下拉找到3处VS2019并选中

界面右下角出现如下提示

稍后输出框有如下输出显示：

此时项目文件夹如图：

build文件夹内容如下：

3. 编译项目

点击VS Code 界面下方的 Build，运行结束后如下：

此时build文件夹内容如下：

4. 测试可执行程序

（1）选中TERMINAL页

（2）进入build文件夹（exe文件所在文件夹）

（3）输入：

.\tutorial.exe 5 3

（4）输出：

E:\TEMP\tutorial\build\tutorial.exe Version 1.0.0
Usage: E:\TEMP\tutorial\build\tutorial.exe(5)

4. 修改代码、重新编译项目（示例参考图示）

（1）打开TutorialConfig.h

（2）将小版本号改为1

（3）build项目

（4）终端再次输入：.\tutorial.exe 5 3

（5）输出

E:\TEMP\tutorial\build\tutorial.exe Version 1.0.1
Usage: E:\TEMP\tutorial\build\tutorial.exe(5)   

（下图注意两个绿色箭头所指，上箭头是修改代码前的输出，下箭头是修改代码后的输出，版本号已改变）：