如何在VS2022中通过CMake创建可以使用SDL3库的项目

目录

1、先创建CMakeList.txt文件

1.1、首先在一个目录(你自己指定)下创建以下两个文件

1.2、下载SDL3库文件并放到对应目录下

1.3、进行有关SDL3的环境变量设置

2、使用VS2022创建项目

2.1、首先打开Visual Studio Installer,确保以下组件已安装

2.2、确保组件安装后,再打开VS2022

2.3、打开CMake文件

2.4、解析CMake文件

2.5、编写源代码文件

3、关于编译生成出来的文件,以及可以删除那些不需要的文件

4、结语


1、先创建CMakeList.txt文件

        想要通过CMake来创建项目,就需要有CMakeList.txt文件,由于CMake的文件编写有些麻烦,且本人目前也没有系统地学习过CMake,所以此处直接粘贴出了可以使用SDL3库的CMake文件。

1.1、首先在一个目录(你自己指定)下创建以下两个文件

其中main.cpp文件可以通过创建文本文件,并将.txt后缀修改为.cpp来创建。

而CMakeList.txt文件的内容如下,读者们直接复制即可:

注意:在CMakeList文件中,“#”表示注释。

#标题
cmake_minimum_required(VERSION 3.10.0) #需求的最低cmake程序版本
project(MyTest VERSION 0.1.0 LANGUAGES C CXX) 
#"MyTest"表示项目名称, VERSION 0.1.0 表示指定项目版本号
# LANGUAGES C CXX    ——   表示指定项目使用的编程语言,C表示C语言,CXX表示C++

#设置C++标准
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED True)

#设置编译选项:设置之后,如果有未引用的变量,或其他问题会报警告
if(MSVC)#如果是微软的C++编译器
    add_compile_options(/W4 /utf-8)#这行代码用于其它系统会报错,加上/utf-8,解决字符串常量的问题
else()
    add_compile_options(-Wall -Wextra -Wpedantic)#用于Window系统会报错
endif()

#设置编译输出目录:指定可执行文件的输出目录
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_DEBUG ${CMAKE_SOURCE_DIR})
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_RELEASE ${CMAKE_SOURCE_DIR})

#设置程序名称,即让生成的可执行文件的名字里面带有指定的平台
#这里的TARGET是变量,是程序的名称
set(TARGET ${PROJECT_NAME}-${CMAKE_SYSTEM_NAME})#这里的${CMAKE_SYSTEM_NAME}是系统名称,比如Windows、Linux、MacOS等

#该方法支持在window、macOS、Linux等平台上使用:
find_package(SDL3 REQUIRED)
find_package(SDL3_image REQUIRED)
find_package(SDL3_ttf REQUIRED)
find_package(SDL3_mixer REQUIRED)

# 这里暂时只有main.cpp,如果后续有其它源代码文件,也需要添加进入,直接换行进行分隔源代码文件即可。
add_executable(${TARGET} main.cpp)

target_link_libraries(${TARGET} 
                        SDL3::SDL3 
                        SDL3_image::SDL3_image 
                        SDL3_ttf::SDL3_ttf
                        SDL3_mixer::SDL3_mixer
                        )

1.2、下载SDL3库文件并放到对应目录下

直接在CMakeList文件中设置了要使用SDL3库也不能直接使用,需要下载好SDL3库文件并设置环境变量才可以正常使用。

这里假设已经下载好了SDL3库文件,并且放到了C:\Library目录下:

SDL3库文件下载连接

注意:由于是上面的链接是GitHub的,所以下载速度可能十分缓慢,甚至打不开。如果有这些问题,可能需要读者们另寻其它渠道来获取资源了。

1.3、进行有关SDL3的环境变量设置

下载好SDL3库文件后,再设置环境变量,这里以Windows11系统举例:

打开设置,并找到系统信息

点击“高级系统信息”:

点击“环境变量”:

然后找到其中的“Path”字段:

最后往“Path”字段中假如SDL3相关库文件的路径:

注意:添加完环境变量之后,不要忘记点击“应用”和“确定”来保存以上设置。

2、使用VS2022创建项目

2.1、首先打开Visual Studio Installer,确保以下组件已安装

2.2、确保组件安装后,再打开VS2022

注意:需要点击“继续但无需代码”:

2.3、打开CMake文件

打开之后,点击左上角的“文件”,然后找到“CMake(M)...”

VS2022里面有一套自己的解析CMake配置文件功能,读者们无需安装额外的CMake文件解析程序。

2.4、解析CMake文件

点击“CMake(M)...”之后,再找到之前存放的CMakeList.txt文件并选择打开即可让VS2022自动开始解析:

2.5、编写源代码文件

打开main.cpp源代码文件,并引入SDL3相关的头文件,即可开始使用SDL3编写程序了。

程序可以正常运行:

3、关于编译生成出来的文件,以及可以删除那些不需要的文件

.vs:是Visual Studio建立的工程文件夹

out:是整个工程编译链接后的输出文件夹:

如果嫌这些文件占用大(以后写程序的话这些文件也确实会变得越来越大),可以将除了CMakeList.txt等配置文件以及main.cpp等源文件之外的文件和文件夹都可以删除

注意:前提是你暂时不需要编写此项目,并且觉得该项目占用大才删除这些不必要的文件。千万不要删除CMakeList.txt和main.cpp文件,不然可能会对项目造成不可逆转的损坏。

4、结语

        我之所以写这篇文章本质上也是为了能够方便日后自己能知道如何通过CMake文件来配置在VS2022使用SDL3库编写的项目,防止以后不记得了也可以看一眼自己写的文章。如果能够帮助到和我有同样问题的读者,那么我会感到万分荣幸。如果路过的大佬看见了,也希望大佬嘴下留情,并指出我这篇文章的不足。

        最后,如果我这篇文章有侵权的迹象,还希望各位读者留言提醒我,我看到之后一定删除这篇文章。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值