CMake 生成 visual studio 工程

目录

• 说明
• 开发环境搭建
• 编写 CMakeLists.txt
• 生成工程
• 更新历史

说明

由于个人工作关系，一直使用Qt作为上位机主要开发框架，Python作为辅助手段，快速验证功能，编写一些测试代码。近期有编译 MSVC 动态库的需求，就折腾了一下 visual studio，用起来十分不习惯。学习过程中发现 CMake 可以生成 visual studio ，学习了一下，记录与此。

开发环境搭建

• CMake 本文猪脚
• visual studio 社区版 安装时需要选择带C++的环境
• vscode 代码编辑器+强大的插件系统

上面三个软件安装完成以后，启动vscode，安装以下插件

• C/C++
• CMake
• CMake Tools

编写 CMakeLists.txt

CMake 是使用 CMakeLists.txt 来管理构建文件的，以下是一个简单的事例

# CMake 最低版本要求
cmake_minimum_required(VERSION 2.18)

# 设置变量
set(OUT_DIR ${PROJECT_SOURCE_DIR}/out)

# 设置变量
set(TARGET_NAME ZaykKey)

# 添加宏定义
add_definitions(-D_CRT_SECURE_NO_WARNINGS)

# 定义工程，对应 visual studio 里的 .sln
project(${TARGET_NAME})

# 添加目录下的源文件到变量中
aux_source_directory(${PROJECT_SOURCE_DIR}/src SRCS)
aux_source_directory(${PROJECT_SOURCE_DIR}/src/algo SRCS)
aux_source_directory(${PROJECT_SOURCE_DIR}/src/platform/windows SRCS)

# ==================================================================
# 生成动态库
add_library(${TARGET_NAME} SHARED ${SRCS} src/zaykkey.def)
# 修改 .def 文件的属性
set_source_files_properties(zaykkey.def PROPERTIES HEADER_FILE_ONLY TRUE)

# 添加链接库，系统库可以直接输入名字，第三方库需要指定路径
target_link_libraries(${TARGET_NAME} hid.lib)
target_link_libraries(${TARGET_NAME} setupapi.lib)

# ==================================================================
# 生成可执行程序
add_executable(interface_test test/main.c)

# 添加链接库
target_link_libraries(interface_test ${PROJECT_SOURCE_DIR}/out/ZaykKey.lib)

# 以下两条注释掉，不起作用
# target_link_libraries(interface_test hid.lib)
# target_link_libraries(interface_test setupapi.lib)

# ==================================================================
# 设置动态库和静态库的输出路径
set(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/out)
# 设置可执行文件的输出路径
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/out)

生成工程

1、新建 build 目录，然后进入 build 目录
2、执行 cmake ..
3、等待一段时间，就可以在 build 目录下看到生成的 visual studio 的 .sln 工程，打开工程以后就可以正常编译测试。

同时也可以使用 vscode CMake Tools 插件提供的功能进行工程构建，所有按钮应该出现在 vscode 左下角，单击各个菜单可以了解具体功能。

更新历史

2022-3-5
第一次发布