c++进阶详解c++开源网络传输库libcurl的编译过程

dvlinker dvlinker     2023-03-12     234

关键词:

目录

1、引言

2、直接编译libcurl工程,提示找不到ssh.h

3、下载并编译libssh2开源代码,部署到libcurl目录中

4、获取openssl开源库的头文件和库文件,部署到libcurl目录中

5、将编译好的libcurl拿到测试项目中测试

6、使用CMake工具手动生成VS工程文件,可以轻易地编译出libcurl库

7、总结


       libcurl是一个免费开源的网络传输库(the multiprotocol file transfer library),支持ftp、ftps、http、https、telnet、ldap、pop3、smtp、rtmp、rtsp、smb等多种协议。libcurl中封装了支持这些协议的网络通信模块,支持跨平台,支持Windows,Unix,Linux等多个操作系统。libcurl提供了一套统一样式的API接口,我们不用关注各种协议下网络通信的实现细节,只需要调用这些API就能轻松地实现基于这些协议的数据通信。本文我们来详细讲述一下如何编译开源的libcurl库。

1、引言

       之前开发的一个工具软件中有个发送告警邮件的功能,最开始试图通过socket套接字去实现邮件的发送,先是和邮件服务器建立连接,然后进行SMTP邮件的协商,协商完成后将邮件发送出去。结果联调测试时遇到了一堆问题,各种网络异常没有得到很好的处理,导致发送邮件功能根本没法使用。

       后来想到了libcurl开源库,该库中封装了smtp邮件协议的所有功能,从连接到协议协商,再到邮件数据的发送,提供一套完整、可靠、稳定的邮件发送机制。于是想去下载libcurl的开源代码,手动将库编译出来,然后再拿到工具软件中使用,同时也正好熟悉一下libcurl开源库的编译过程。

       关于发送告警邮件的项目,可以查看之前写的文章:(文章中提供C++源码下载

IPC摄像头在线状态ping检测与告警邮件发送项目总结(提供源码下载)https://blog.csdn.net/chenlycly/article/details/120690137

2、直接编译libcurl工程,提示找不到ssh.h

       到libcurl的官网上下载libcurl源码。我下载的是2022年5月11日发布的curl 7.83.1版本。解压后,打开curl-7.83.1\\projects\\Windows目录,该目录中保存了支持Widnows平台上的Visual Studio编译的工程文件,提供了对多个Visual Studio版本的支持:

此处我是用Visual Studio 2010编译的,所以选择VC10目录。打开VC10目录,双击curl-all.sln解决方案文件启动VS2010打开解决方案,该解决方案中包含了curl和libcurl两个工程,libcurl是动态库工程,我们编译该工程就可以了。

在libcurl源代码根路径中提供了CMakeLists.txt文件,如果开源库中不提供支持Visual Studio编译的工程文件,我们可以对CMakeLists.txt文件使用CMAKE工具,生成指定版本的Visual Studio工程文件。注意在使用CMake工具时,开源代码的所在路径必须是全英文的,不能包含中文,否则CMake工具会将路径中的中文字符识别位乱码,导致生成Visual Studio工程文件失败。

        启动对libcurl工程的编译后,就报错了,如下所示:

1>------ 已启动生成: 项目: libcurl, 配置: DLL Release - DLL OpenSSL Win32 ------
1>生成启动时间为 2022/5/17 16:32:39。
1>InitializeBuildStatus:
1>  正在创建“..\\..\\..\\..\\build\\Win32\\VC10\\DLL Release - DLL OpenSSL\\lib\\libcurl.unsuccessfulbuild”,因为已指定“AlwaysCreate”。
1>ClCompile:
1>  x509asn1.c
1>  wolfssl.c
1>  vtls.c
1>e:\\开源库集合\\curl-7.83.1\\lib\\vssh/ssh.h(28): fatal error C1083: 无法打开包括文件:“libssh2.h”: No such file or directory
1>  sectransp.c
1>e:\\开源库集合\\curl-7.83.1\\lib\\vssh/ssh.h(28): fatal error C1083: 无法打开包括文件:“libssh2.h”: No such file or directory
1>  schannel_verify.c

提示找不到ssh.h。从解决方案配置中看到了libssh2库的身影,应该是当前的libcurl库使用了开源的libssh2库,于是去下载libssh2开源库代码,一是拿到libssh2库的头文件,二是将libssh2库的库文件编译出来,libcurl链接时肯定要用到libssh2库的。

3、下载并编译libssh2开源代码,部署到libcurl目录中

       SSH为Secure Shell的缩写,专为远程登录会话和其他网络服务提供安全性的协议。利用 SSH 协议可以有效防止远程管理过程中的信息泄露问题。SSH1由于存在安全漏洞,所以产生了更为安全的SSH2,开源libssh2库实现了SSH2协议。

       到libssh2官网上下载libssh2源码,解压后打开根路径,发现根路径下有个win32文件夹,点进去后看到Visual Studio相关的工程文件,如下所示:

工程文件是VC++6.0版本的,直接将工程文件拖到VS2010中,将工程文件升级到VS2010版本,然后发起编译,很快就编译完成了。

       查看了一下libssh2工程的属性,发现该工程编译出来的是静态库,不是动态库,如下所示:

因为此处生成的是libssh2静态库,所以我们在libcurl的解决方案配置中选择“DLL Release - DLL OpenSSL”工程选项:

这个选项是使用libssh2静态库的。而DLL Release - DLL OpenSSL - DLL LibSSH2选项中则使用的是libssh2动态库,所以我们要使用前者。

       于是将libssh2库目录中的include头文件以及编译出来的静态库拷贝到libcurl的工程目录curl-7.83.1中。我们在curl-7.83.1目录中创建一个名叫libssh2文件夹,然后在该文件夹中创建一个用来存放头文件的include文件夹和一个用来存放libssh2静态库的lib文件夹,如下:

        于是我们到libcurl的工程属性中修改一下配置,首先修改引用libssh2\\include下头文件的路径(包含头文件):

然后修改引用libssh2\\lib目录下的libssh2.lib文件的路径(链接时引入的.lib文件):

       于是继续编译libcurl工程,结果又提示找不到ssl.h头文件:

1>------ 已启动生成: 项目: libcurl, 配置: DLL Release - DLL OpenSSL Win32 ------
1>生成启动时间为 2022/5/17 17:01:17。
1>InitializeBuildStatus:
1>  正在对“..\\..\\..\\..\\build\\Win32\\VC10\\DLL Release - DLL OpenSSL\\lib\\libcurl.unsuccessfulbuild”执行 Touch 任务。
1>ClCompile:
1>  x509asn1.c
1>  wolfssl.c
1>  vtls.c
1>  sectransp.c
1>  schannel_verify.c
1>  schannel.c
1>  rustls.c
1>  openssl.c
1>..\\..\\..\\..\\lib\\vtls\\openssl.c(63): fatal error C1083: 无法打开包括文件:“openssl/ssl.h”: No such file or directory
1>  nss.c
1>  mbedtls_threadlock.c

应该是和libssh2库一样,也需要获取openssl开源库的头文件和库文件。

4、获取openssl开源库的头文件和库文件,部署到libcurl目录中

       到curl-7.83.1目录中去搜索,也找不到ssl.h文件。那应该是要去下载openssl开源库的源码并编译。到openssl官网上将源码下载下来,解压后在根路径中没有找到Windows平台编译专用的Visual Studio的工程文件,而libcurl和libssh2源码中是有专用的Visual Studio工程文件的。如果要手动编译openssl,则需要安装perl工具,然后通过perl去执行代码的编译,这个过程略显复杂。

       我们可以到第三方网站上去下载别人已经编译好的openssl库,比如:

Win32/Win64 OpenSSL Installer for Windows - Shining Light Productionshttp://slproweb.com/products/Win32OpenSSL.html打开页面后,将页面向下拉动找到下载链接,我们的软件是32位的,所以选择32位版本的openssl即可。但下载链接比较多,我们只需要选择Win32 OpenSSL v3.0.3 Light版本即可,点击MSI按钮,下载MSI安装包:

然后执行该MSI安装包,这样就能把openssl头文件和库文件释放到目标路径中。然后打开安装目录查看安装的内容,从include路径中取出所有头文件,从lib路径中取出用于链接的.lib库,从bin路径中取出libssl-3.dll及其依赖的库。

       lib路径中的文件比较多:

我们只需要取出libcurl链接时要用的libssl.lib库文件即可。

       bin路径下的文件也比较多,除了要拿openssl库的主文件libssl-3.dll,还要取出哪些libssl-3.dll库依赖的dll文件呢?其实很简单,我们只需要使用Dependency Walker工具打开libssl-3.dll文件,看看libssl-3.dll依赖哪些dll库,如下所示:

除去libssl-3.dll依赖的一些系统库之外,我们看到了libssl-3.dll依赖了libcrypto-3.dll库,

在这个地方有个细节需要注意一下,Dependency Walker工具在Win10系统中打开dll很慢,等待的时间会比较长,估计得等1分钟左右,使用时要去耐心等待一会,等待Dependency Walker打开dll库完成,估计是因为Dependency Walker对Win10的兼容性不好导致打开dll文件很慢的。

       和libssh2库处理类似,我们也在curl-7.83.1目录的根目录中创建一个openssl目录,在该目录再创建一个存放openssl头文件夹include,再创建一个存放.lib和.dll文件的lib路径。然后从之前Win32 OpenSSL v3.0.3 Light的安装目录中将相关文件拷贝过去。

       接下来,我们到libcurl的工程属性中修改一下配置,首先修改引用openssl\\include下的头文件路径(包含头文件):

然后修改引用openssl\\lib目录下的libssl.lib文件的路径(链接时引入的.lib文件):

于是再编译libcurl工程,结果还是报找不到ssl.h头文件的错误:

1>------ 已启动生成: 项目: libcurl, 配置: DLL Release - DLL OpenSSL Win32 ------
1>生成启动时间为 2022/5/17 17:01:17。
1>InitializeBuildStatus:
1>  正在对“..\\..\\..\\..\\build\\Win32\\VC10\\DLL Release - DLL OpenSSL\\lib\\libcurl.unsuccessfulbuild”执行 Touch 任务。
1>ClCompile:
1>  x509asn1.c
1>  wolfssl.c
1>  vtls.c
1>  sectransp.c
1>  schannel_verify.c
1>  schannel.c
1>  rustls.c
1>  openssl.c
1>..\\..\\..\\..\\lib\\vtls\\openssl.c(63): fatal error C1083: 无法打开包括文件:“openssl/ssl.h”: No such file or directory
1>  nss.c
1>  mbedtls_threadlock.c

后来查阅代码得知,代码中引用ssl.h头文件的地方,都加上了openssl相对路径,如下:

       为了解决这个问题,我们再在include中添加一个openssl子文件夹,将所有openssl的头文件都搞到这个openssl子文件夹中存放,然后libcurl就能编译通过了。

5、将编译好的libcurl拿到测试项目中测试

       将编译好的release版本的libcurl库及其依赖的几个库,拷贝到之前编写的包含发送邮件的程序中编译,运行测试程序,打开邮箱参数设置窗口,如下所示:

在邮箱参数设置窗口中填写好163邮箱SMTP服务器地址及端口、发送邮件地址和接收邮件通知的接收邮件地址,点击“发送接收邮件”按钮,发送测试邮件。经验证,是可以将测试邮件发出去的:

目标邮箱中也是能收到邮件的,邮件内容也是正确的。

       至于如何开通发送邮件中的SMTP服务,可以参见之前写的这篇文章:

VC++调用libcurl开源库实现发送邮件的功能(附源码)https://blog.csdn.net/chenlycly/article/details/121318616

6、使用CMake工具手动生成VS工程文件,可以轻易地编译出libcurl库

       libcurl开源代码的根目录中就有个CMakeLists.txt文件,该文件中配置了生成Windows平台上的Visual Studio工程文件的相关内容,于是使用CMake工具尝试自行生成VS工程文件。

CMake 是一个跨平台的开源构建系统,通过读取放置在每个源码根目录中的配置文件CMakeLists.txt中的内容,生成指定平台的标准构建文件,比如为 Unix 平台生成makefiles文件(用GCC编译),为 Windows平台的MSVC(Microsoft Visual Studio C++)生成 projects/workspaces(用Visual Studio编译)或makefile文件(用nmake编译)。

       打开CMake工具后,先设置libcurl源码的根路径,然后再设置生成的Visual Studio工程文件的目录:

然后点击Generate按钮,弹出选择哪种解决方案:

此处我们需要使用VS2010,所生成VC++工程文件的时间比较长,大概需要等待几分钟时间,生成完成后,我们打开对应的目录,如下所示:

打开后编译libcurl工程即可,编译速度很快。根据编译时打印的信息得知,该种方式下使用的是wolfssl,没有使用openssl,libcurl的目录中也找不到openssl的头文件,所以通过CMake工具生成的VS工程编译时不需要libssh2和openssl开源库了,如下:

根据编译输出的路径,可以到对应的路径中找到生成的libcurl库文件:libcurl_imp.lib和libcurl.dll。

        相比于上面那种编译libssh2开源库及获取openssl库的方式,这种方式要简单的多。将libcurl_imp.lib和libcurl.dll拿到测试工具的工程中测试,也是能正常发送邮件的。

7、总结

       上面使用了两个途径去编译libcurl库。一种是使用libcurl开源库自带的VS工程去编译,但要先去编译libssh2开源库,然后去获取openssl开源库的头文件及库文件,最后再来编译libcurl工程。另一种方式是使用CMake工具,输入CMakeLists.txt,即可自动生成VC的工程,可以直接编译出libcurl库,不需要再去编译libssh2和openssl库。经测试,这两种方式编译出来的库都是可用的,都能将测试邮件发送出去。

用 C++ 构建 libcurl 库,菜鸟问题

】用C++构建libcurl库,菜鸟问题【英文标题】:Buildinglibcurllibraryinc++,NoobQuestion【发布时间】:2009-12-0904:25:17【问题描述】:我想用libcurl写一个小C++程序。这是一个学校项目,所以我需要能够将所有内容打包成一个zip文件并将其通... 查看详情

我的c/c++语言学习进阶之旅关于vcpkg的参考资料:一个让你可以快速引用c++开源库的包管理工具vcpkg,快来使用vcpkg管理你的c++项目中的依赖项吧!(代码片段)

...滑块怎么做的,通过我们上一篇博客【我的渲染技术进阶之旅】关于C++轻量级界面开发框架DearImGui介绍我们一眼就可以看出来是使用ImG 查看详情

c++游戏服务器编程学习笔记

...逻辑常见的游戏服务器框架和重点部分的实现IP网际协议详解OSI模型开放系统的通信交互模型学术性产物的应用层、表示层、会话层、传输层、网络层、链路层、物理层IP模型产生于实践用于实践成为标准数据进入协议栈的封装... 查看详情

我的c/c++语言学习进阶之旅关于vcpkg的参考资料:一个让你可以快速引用c++开源库的包管理工具vcpkg,快来使用vcpkg管理你的c++项目中的依赖项吧!(代码片段)

...滑块怎么做的,通过我们上一篇博客【我的渲染技术进阶之旅】关于C++轻量级界面开发框架DearImGui介绍我们一眼就可以看出来是使用ImGui做的。然后那人A问这个ImGui怎么集成的,另外一个人B回复使用微软的C++... 查看详情

开源 C++ 游戏引擎数学库?

】开源C++游戏引擎数学库?【英文标题】:OpenSourceC++gameenginemathlibraries?【发布时间】:2009-10-1501:18:28【问题描述】:我正在寻找一个免费使用的游戏引擎数学库。具体来说,我想要一个好的矩阵和向量实现。以及在3D空间中移动... 查看详情

经验分享:适合c++学习的开源项目(基础到进阶实战)

俗话说:万事开头难,学习编程也是一样。在我粉丝学习群里,经常遇到有小伙伴询问编程语言如何入门方面的问题,如:我要学习某一门编程语言,有什么开源项目可以推荐吗?我是某编程语言的新... 查看详情

用于 C++ 的开源、跨平台 CD/DVD 录制库 [关闭]

】用于C++的开源、跨平台CD/DVD录制库[关闭]【英文标题】:Opensource,crossplatformCD/DVDrecordinglibraryforC++[closed]【发布时间】:2011-06-0508:40:12【问题描述】:我正在寻找适用于C++(Qt)的开源、免费和跨平台CD/DVD/BD录制库。有人有什么建议... 查看详情

用于在 C++ 中抽象数据库访问的开源库?

】用于在C++中抽象数据库访问的开源库?【英文标题】:OpensourcelibrariesforabstractingdatabaseaccessinC++?【发布时间】:2010-01-2103:03:00【问题描述】:我正在寻找从我的应用程序中抽象出数据库服务器详细信息的选项(在c++中),我想... 查看详情

c++多线程中使用libcurl库的问题

我想开启五个线程,从URL队列中读取URL,并使用libcurl库下载网页源码(每个源码存在一个对应的html文件里),但是五个线程间的互斥量设置问题不太了解。目前我只在读取URL的时候设置了互斥量,但在libcurl的使用中没有加互斥... 查看详情

红黑树特性和实现详解——c++进阶数据结构(代码片段)

文章目录1.红黑树的概念2.红黑树的性质3.与AVL树进行效率比较4.红黑树结点的定义5.红黑树的插入5.1.cur为红,p为红,u存在且为红5.2cur为红,p为红,u不存在或者存在且为黑色5.2.1直线情况:单旋处理5.2.2曲线情... 查看详情

八个c++开源项目,帮助初学者进阶成长

ThreadPool一个简单的C++11线程池实现,只有一个头文件,代码加起来不到100行。GitHub地址:https://github.com/progschj/ThreadPoolsudokuC++实现的命令行数独游戏。600余行代码,初学者也可以轻松学习。GitHub地址... 查看详情

八个c++开源项目,帮助初学者进阶成长

ThreadPool一个简单的C++11线程池实现,只有一个头文件,代码加起来不到100行。GitHub地址:https://github.com/progschj/ThreadPoolsudokuC++实现的命令行数独游戏。600余行代码,初学者也可以轻松学习。GitHub地址... 查看详情

c++标准模板库(stl)——stack常见用法详解(代码片段)

标准模板库(STL)是程序员定义的数据类型和算法的集合,可供C++程序使用。这些数据类型和算法不是C++语言的一部分,但它们的创建是对内置数据类型的有益补充。如果打算继续在计算机科学领域学习,那么就应该熟悉STL。本... 查看详情

DLIB 是一个很好的开源库,可以用 C++ 开发我自己的机器学习算法吗?

】DLIB是一个很好的开源库,可以用C++开发我自己的机器学习算法吗?【英文标题】:IsDLIBagoodopensourcelibraryfordevelopingmyownmachinelearningalgorithmsinC++?【发布时间】:2011-06-1319:01:59【问题描述】:DLIB是一个很好的开源库,可用于用C++... 查看详情

好c++中lib和dll的区别生成以及使用详解

...cnblogs.com/TenosDoIt/p/3203137.htmllib和dll的区别、生成以及使用详解【目录】libdll介绍生成动态库调用动态库生成静态库调用静态库 首先介绍一下静态库(静态链接库)、动态库& 查看详情

c++中常用的网络通信库

libcurlcprzmqcppzmq 查看详情

c++中常用的网络通信库

libcurlcprzmqcppzmq 查看详情

c++从入门到进阶的系列书籍推荐

目录1、C++入门书籍1.1、C语言程序设计(谭浩强)1.2、C++Primer中文版(第5版)2、VC++/MFC书籍2.1、VC++深入详解(孙鑫)2.2、深入浅出MFC(侯捷)3、C++进阶书籍3.1、 查看详情