前言
最近想要基于C++实现xlsx文件的读写,了解到OpenXLSX这个库比较好用.因为我没怎么用过visual studio,对c++添加第三方库十分的陌生。经过边猜边摸索成功加载。给其他的新手一点参考,将过程记录总结如下:
库下载的官方地址:OpenXLSX/OpenXLSX at master · troldal/OpenXLSX · GitHub
前置知识
visual studio中的项目有两种,一种一般新手教程中创建空项目的生成的是依赖于.snl和.vcxproj文件的项目,是适用于win系统。还有另一种创建项目的方式是创建Cmake项目,这种项目不依赖于.snl文件和.vcxproj文件,适合win和linux进行跨平台。Visual Studio 中的 CMake 项目 | Microsoft Learn
这里需要提前安装Cmake,具体的信息可以参考官方文档,网上也有很多教程CMake Reference Documentation — CMake 3.27.0-rc4 Documentation
在OpenXLSX的作者建议中,这个库的使用是比较适合将其集成到自己的Cmake项目中的。也是比较简单的方式,方便自己的代码进行移植。
操作过程
git仓库介绍
将整个仓库下载下来,或者只下载库源代码
在VS中创建自己的Cmake项目
新建项目中选择Cmake
注意我这里是选择“新建解决方案”,会多一重文件夹。后续的操作是进入项目(!!是项目)
(一个解决方案中可以包含多个项目)
项目里会有三个文件,CMakeLists.txt、CMakeProject2.cpp和CMakeProject2.h。这一步中VS其实帮我们自动载入了CMakeLists.txt文件的内容。后面两个文件就是我们自己项目中写代码和头文件的位置
导入库源代码作为子文件夹,并加载CmakeLists.txt
将下载下来的OpenXLSX库源代码作为该项目的子文件夹,移动过后的项目文件应该变成:
借助VS加载一下OpenXLSX库中的CmakeLists.txt文件,点击工具栏打开-->camke文件
打开后等待几秒得到输出的out文件夹,则表明配置成功
编辑项目的CmakeLists.txt内容
重新回到项目中,打开项目的CmakeLists.txt可以看到如下内容:
添加库和连接,注意项目名称改成自己的项目名称。编辑完成后保存,会自动载入相关内容。
add_subdirectory(OpenXLSX)
target_link_libraries(CMakeProject2 OpenXLSX::OpenXLSX)
测试,看是否能导入库
导入.hpp文件,不报错就是成功啦!
对于Cmake更强大的功能和配置可以参考官方的文档~