【交叉编译踩坑指北（一）】windows10下Vscode与Cmake编译生成文件

1、工具链安装

  工具链版本如下

C:\Users\Lenovo>cmake -version
cmake version 3.24.2

C:\Users\Lenovo>mingw32-make -v
GNU Make 4.2.1 Built for x86_64-w64-mingw32

  若没有以上工具则进行安装，将bin文件加入到环境变量中，注意：有的交叉编译器在安装时选择自动加入环境变量可能并不会加入，还是需要手动加入环境变量，本章首先介绍MinGW编译器，其环境变量如图中所示，位于D盘bin目录下
  该目录下包含了mingw的一系列工具链
  包括mingw的make文件，mingw32-make（在运行makefile时要使用mingw32-make而不是make）

  还有mingw的gcc文件，用于编译.c文件生成可执行文件

  它们的关系是这样的：make用于执行Makefiles，Makefiles中包含了一系列的gcc语句用于编译连接，因此make相当于借助makefiles执行一系列gcc指令的指令。（这里的make代表了一系列的make工具，对于mingw是mingw32-make，对于其他工具可能是其他名字。gcc也同理，这里是x86_64-w64-mingw32-gcc）

---

  一个小探究，这里发现mingw的bin文件夹下除了x86_64-w64-mingw32-gcc还有一个gcc文件，但当我们在cmd中查看他们各自的版本时发现提示是一样的

C:\Users\Lenovo>gcc -v Using built-in specs. COLLECT_GCC=gcc
COLLECT_LTO_WRAPPER=D:/mingw64/bin/…/libexec/gcc/x86_64-w64-mingw32/8.1.0/lto-wrapper.exe
Target: x86_64-w64-mingw32

C:\Users\Lenovo>x86_64-w64-mingw32-gcc -v Using built-in specs.
COLLECT_GCC=x86_64-w64-mingw32-gcc
COLLECT_LTO_WRAPPER=D:/mingw64/bin/…/libexec/gcc/x86_64-w64-mingw32/8.1.0/lto-wrapper.exe
Target: x86_64-w64-mingw32

  应当是都被重定向到了同一个可执行文件

---

2、安装Vscode插件

C/C++
Cmake
Cmake Tools

3、CMake介绍

  CMake是一个跨平台的Makefile生成工具
  依赖的文件是CMakeLists.txt，其作用简单归结为：

cmake执行CMakeLists.txt生成Makefiles，然后make执行Makefiles，调用Makefiles中一系列gcc编译生成可执行的目标文件

  在这个过程中，make有不同的工具，gcc也有不同的工具，因此在整个工具链中需要进行配置。例如如果是生成windows可执行文件，Cmake就要配置生成MinGW Makefiles，执行Makefiles要选择mingw32-make，编译器要选择x86_64-w64-mingw32-gcc

4、VScode中CMake的使用

shift+ctrl+P:并输入如下指令
cmake:quick start

为本工程开启CMake tools

然后就会看到cmake tools在vscode中的UI
可以点击这里

来进行配置编译器的选择，比如mingw编译器或者arm交叉编译器

5、操作流程（简易版Cmake，无文件层次）

5.1创建文件夹并在VScode中打开

  在桌面上新建了一个空文件夹test_hello，并在VScode中打开文件夹

5.2创建文件hello.c

hello.c

#include
int main(){
    printf("HELLO\n");
    return 0;
}

5.3创建文件CMakeLists.txt

CMakeLists.txt

#cmake使用#注释
cmake_minimum_required(VERSION 3.0)#指定最低版本，不超过前面查看的当前版本
project(hello_simple)#指定当前项目名称
add_executable(hello hello.c)#指定生成目标、源文件

5.4配置VScode插件CMakeTools选项

进入用户设置
 
 
 

选择CMakeTools设置
 
 
 
可以看到生成文件的默认目录是会在当前文件夹下创建一个build文件夹，生成文件都生成在这个build文件夹中
 
 
 
此外还有源代码目录选择，这个和build一样，都先默认不设置

 
 
 
CMake生成器（Generator）配置。
CMake不编译或链接任何源文件，它使用生成器为构建系统创建配置文件。
相当于在终端（cmd或者powershell）中输入cmake -G后面的参数，例如cmake -G “MinGW Makefiles”

在终端输入

cmake -help

可以看到-G可选参数，其中常见的有这几种。也就是说在上述Cmake:Generator中可选这些生成器，*号表示默认的生成器

5.5开启CMakeTools的UI并选择编译器

shift+ctrl+P

弹出的窗口输入：

cmake:quick start

 
 
 
并点击,会弹出来如下选择
第一次使用时推荐第一个，这个会在本机中扫描编译器和交叉编译器（前提是必须先添加到系统环境变量中，详见本章第一节），特别是遇到BC没出现的情况时，点击A后UI会自动启动，然后在窗口底部的这个位置可以点击选择编译器。
这里选择x86_64-w64-mingw32-gcc 构建windows系统的可执行文件，则生成文件是exe格式的。

 
 
点击build进行构建，部分输出如下
可以根据提示知道最后成功构建了可执行文件hello.exe（在build文件下）

由此可知，VScode中的CMakeTools可以一步到位完成构建生成，而不是像终端中那样，先构建生成Makefile，然后再用make指令生产最终可执行文件。

---

这里稍微拓展一下，如果要在终端进行构建的话，如果前面cmake -G参数选的是MinGw Makefiles，那么后面make指令就要选mingw工具链中的make，即mingw64-make（第一节中所介绍的）指令来执行Makefile，这体现了工具链的对应性和一致性

---

5.6执行生成文件，观察结果

可以看到，生成文件都在build中，包含了中间文件Makefile，还有目标文件hello.exe等。
直接在终端中cd到build下（输入E: 按下回车可以改变到对应盘符）输入

./hello.exe

结果如下，这里用的是VScode内置powershell
成功输出结果，圆满完成任务！