【C++开源库】Windows 下编译 libcurl 库
一、简介
libcurl 是一个跨平台的网络协议库,支持 http, https, ftp, gopher, telnet, dict, file, 和 ldap 协议。libcurl 同样支持 HTTPS 证书授权,HTTP POST, HTTP PUT, FTP 上传, HTTP 基本表单上传,代理,cookies 和用户认证。想要知道更多关于 libcurl 的介绍,可以到官网 http://curl.haxx.se/上去了解,在这里不再详述。
二、编译 libcurl
libcurl 没有提供编译好的库,需要自己编译,先下载 libcurl 源代码。下载方式:
- github 页面:https://github.com/curl/curl
- libcurl 官网:https://curl.haxx.se/download.html
笔者这里选择官网下载,下载最新版本为 curl-7.76.1
,我是 Windows 平台,所以选 zip 文件。
下面介绍 3 种编译方法:
- nmake 编译,想了解 cmake 与 nmake 的区别可以参考:5分钟理解make/makefile/cmake/nmake
- CMake 编译,请参考:libcurl库源码编译,安装c++
- 使用源码自带的 .sln 编译,具体步骤可参考:【C++】VS2013下CURL编译及使用示例
笔者原先使用 CMake 编译,最后生成了 libcurl.dll,但即使设置生成静态库,也没有生成 .lib,在网上查找生成 .lib 的方法,需要有链接器中配置,但源码工程中没有链接器一项,由于时间原因暂时没有深入研究下去。
也不推荐源码自带的 .sln 编译方法,因为 libcurl 依赖以下库(以下库版本为当前最新版本),还需要下载解压这些库,比较麻烦:
推荐使用第一种方式,笔者采用这种方法编译成功,下面详细介绍 nmake 编译方法。
nmake 编译
(1)下载完成后解压,并进入文件夹,运行buildconf.bat
。
(2)在开始菜单中找到 Visual Studio 2019
文件夹,编译 64 位则右击 x64 Native Tools Command Prompt for VS 2017/2019
,编译 32 位则右击 x86 Native Tools Command Prompt for VS 2017/2019
,选择管理员方式运行。
(3)进入 curl 文件夹中的 winbuild
文件夹。
(4)2019 + x64 + release + 静态编译:
nmake /f Makefile.vc mode=static VC=15 MACHINE=x64 DEBUG=no
- 如需动态编译,将 mode=static 改为 mode=dll。(本文仅演示静态编译,同时 curl 官方也不建议使用动态编译)
- 如需编译为 x86,将 MACHINE=x64 改为 MACHINE=x86。
- 如需编译为debug版,将DEBUG=no改为DEBUG=yes。
- 如果你是 VS2019,VC=15 建议改为 VC=14。
- 更详细的编译指令及说明可以打开 winbuild 文件夹中的
BUILD.WINDOWS.txt
查看。
(5)回车,等待编译完成,关闭控制台界面。编译出的库路径为 C:\Users\xianf\Downloads\curl-7.76.1\builds\libcurl-vc15-x64-release-static-ipv6-sspi-schannel
。
详细图文教程请参考:Visual Studio(VS2017/VS2019)编译并配置C/C++-libcurl开发环境
nmake 是 Microsoft Visual Studio 中的附带命令,需要安装 VS,即 Windows 上的 make。
如果不了解各个 VS 命令提示工具的区别,可以去看:VS 命令提示工具
三、配置工程
(1)新建一个项目。本文选择新建一个名为 Test
的空项目,修改为 Release + x64 配置;
(2)配置 include 和 lib 路径,将以下 lib 添加至工程:
libcurl_a.lib
Ws2_32.lib
Wldap32.lib
winmm.lib
Crypt32.lib
Normaliz.lib
(3)属性 -> 高级 -> 字符集下拉框,使用多字节字符集;
(4)本文使用了静态编译,所以需要将 CURL_STATICLIB
添加至工程;
(5)本文使用了静态编译且没有编译 debug 版 libcurl,所以直接在 Configurations: All Configurations
中将 Runtime Library
选择为 /MD
。
- 如果编译了 debug 版 libcurl,请分别在
Configurations: Debug
中选择/MDd
、Configurations: Release
中选择/MD
。 - 如果使用了动态编译,则为
/MTd
和/MT
。
四、测试代码
#include <curl/curl.h>
int main(int argc, char* argv[]) {
CURL* curl = nullptr;
CURLcode res;
curl = curl_easy_init();
if (curl != nullptr) {
curl_easy_setopt(curl, CURLOPT_URL, "http://www.baidu.com");
/* example.com is redirected, so we tell libcurl to follow redirection */
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
/* Perform the request, res will get the return code */
res = curl_easy_perform(curl);
/* Check for errors */
if (res != CURLE_OK) {
fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
}
/* always cleanup */
curl_easy_cleanup(curl);
}
return 0;
}
参考:
Visual Studio(VS2017/VS2019)编译并配置C/C++-libcurl开发环境