[笔记]基于VSCode使用cmake配置使用第三方库文件(SFML等)的项目

本文详细指导如何在Windows 10的VSCode中配置CMake以构建包含SFML第三方库的项目,涉及项目结构、CMakeLists.txt编写和编译调试过程,旨在简化第三方库管理及跨平台兼容性。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

前言

本文主要实现的是在windows10下使用VSCode编辑器以及cmake工具来构建一个包含第三方库文件(此处为SFML)的项目的配置和调试。(因为SFML库文件的cmake比较难搞,,所以我自认为重点是其cmakelists.txt的编写)。
首先要保证VSCode可以正常使用MinGW编译器来编译运行C++程序、已经安装并能使用cmake。

构建基础项目结构

首先贴一下项目的大致结构:
其中:

  • build 一般按照项目的习惯是作为整个项目编译后的文件所在的文件夹,可以理解为变异的得到的可执行程序以及需要的资源的文件夹(即main.exe)
  • CMakeFiles 这个是cmake执行时自动生成的一些文件,不用管
  • external 这个一般就是我们项目引入第三方库文件的所在的文件夹,这里的文件一般要去你所需的库文件的官网下载 适合自己平台 的编译好的文件。(这里后面再说)
  • include 这个一般是包含在编写代码时为了自动补全等需要的头文件等等内容。
  • res 一般是一些项目的资源文件,如图片、视频、音频、纹理、模型等等。
  • src 即我们项目自己编写的源码文件夹。
  • CMakeLists.txt 这个文件是项目的一个配置文件,对于不同平台环境的使用者,都可以使用 cmake 命令来解释此文件来生成适合自己环境的项目编译等的 Makefile 文件。比如,我们win下完成的项目,只要编写一个合适的 CMakeLists.txt ,使用 cmake 命令就可以生成 win下的一个编译项目的方式(包括 Makefile 和资源文件、依赖文件等等的内容,一般就在 build 文件夹中) 。而另一个 unix 用户,也可以通过其 cmake 命令来生成自己平台下的 build 文件夹。这样无论是什么平台下的用户,都可以使用本平台的 make 命令来编译运行我们的项目。这也是使用 cmakemake 命令来管理项目的一个原因吧。
  • 其他几个文件示项目不同。
  • 此外,一般还包含单元测试 test 文件夹等内容。

关于 external 文件夹、SFML以及cmake命令:

对于 SFML 来说,需要去 SFML Downloads 下载适合本平台的版本,(比如我,设备安装的是MinGW64,所以我下载的就是GCC 7.3.0 MinGW (SEH) - 64-bit这个版本的)然后将其解压并复制到 external 文件夹下就行了,

其实就是相当于引入第三方库的 头文件 以及 需要链接的.a 文件,至于一些 .dll 文件,我们可以直接复制到编译好的程序的同级目录下即可,

解释

对于前面两个引入,我们可以通过 g++ main.cpp -IIncludePath -LLibsPath -o main.exe 来搞定,当然为了简化输入命令的过程,可以通过编写 Makefile 文件来简化,,这样通过 make 命令就可以编译、运行、清理环境等等。

对于最后一个引入,我们可以通过编写 cmake 的 CMakeLists.txt 来实现将确定位置的 .dll 文件拷贝的操作。

整理一下这个流程:

  • 我们需要简化 main.cpp 等源文件和第三方文件的编译、链接操作,可以通过 make 命令对 Makefile 文件解释来实现;
  • 我们需要简化对整个项目中的第三方文件以及不同平台上的项目的配置操作,所以通过 cmake 来解释 CMakeLists.txt 文件来生成适合本平台下的 Makefile 文件。

(对于java系,引入第三方包,直接将jar包拖到IDE就能配置好,,当然C++下的IDE也可以实现这样的操作,,仅仅是IDE实现了 CMakeLists.txt 的一些功能,将其集成到一个按钮上)

接下来进入到具体到 使用SFML库CMakeLists.txt 的编写。

CMakeLists.txt 的编写

首先贴一下我当前 SFML 在项目中的位置:(上文提到的下载位置、解压、将

然后在项目的根目录中添加一个 项目名Config.h.in 文件,其中的内容如下(否则可能后续cmake会报错):

#define 项目名_VERSION_MAJOR @项目名_VERSION_MAJOR@
#define 项目名_VERSION_MINOR @项目名_VERSION_MINOR@
### 设置和使用 CMake 进行项目构建配置 #### 安装必要的软件包 为了能够在 Visual Studio Code (VSCode) 中顺利使用 CMake 构建 C++ 项目,需先安装几个必备组件:CMake、MinGW 和 VSCode 自身。对于编译器的选择,在 Windows 平台上通常采用 MinGW 工具链来完成源码到二进制文件的转换过程[^1]。 #### 配置 VSCode 插件和支持工具 接着应确保已安装了 `CMake Tools` 扩展插件,该插件提供了对 CMake 文件的强大支持功能,比如语法高亮显示、智能感知以及错误提示等特性,极大地方便了开发人员的工作流程[^3]。此外还需调整 VSCode 的全局设置以指定本地安装好的 CMake 可执行路径: ```json { "cmake.cmakePath": "/path/to/cmake" } ``` 此段 JSON 代码应当被加入至用户的 `.vscode/settings.json` 文件内以便生效[^2]。 #### 初始化并配置项目 当一切准备就绪之后就可以开始创建一个新的 C++ 项目了。进入项目的根目录并通过终端运行如下命令初始化 CMake 项目结构,并指明生成器为 `"MinGW Makefiles"` 来适配所选的 GCC 编译体系;这一步骤会在当前工作区建立名为 `build` 的子目录用于存放所有中间产物及最终目标程序: ```bash cmake -S ./ -B ./build -G "MinGW Makefiles" ``` 上述操作完成后,可以通过快捷键组合 Ctrl+Shift+P 调出命令面板,从中选取 “CMake: Configure”,随后按照向导指示选择合适的编译器版本(例如 GCC),此时系统将会自动处理后续事宜直至整个环境搭建完毕[^5]。 #### 测试验证 最后可通过简单的 Hello World 程序来进行初步的功能性检测,确认整个集成开发环境中各个部分均能正常协作运作。具体做法是在主函数中打印一条消息字符串,保存更改后再回到命令面板里依次挑选 “CMake: Build Project” 和 “Debug: Start Debugging”。如果一切顺利的话,则可以在控制台窗口看到预期输出结果。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值