libhv项目构建指南：从入门到精通-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00816/article/details/148464579

libhv项目构建指南：从入门到精通

libhv 🔥 比libevent/libuv/asio更易用的网络库。A c/c++ network library for developing TCP/UDP/SSL/HTTP/WebSocket/MQTT client/server. 项目地址: https://gitcode.com/gh_mirrors/li/libhv

前言

libhv是一个高性能的跨平台网络库，提供了丰富的网络编程功能。本文将详细介绍如何在不同平台和环境下构建libhv项目，帮助开发者快速上手并充分利用这个强大的网络库。

构建环境准备

在开始构建libhv之前，需要确保系统满足以下基本要求：

支持C99标准的C编译器
支持C++11标准的C++编译器
推荐使用gcc4.8+或msvc2015及以上版本

构建方式选择

libhv支持多种构建系统，开发者可以根据自己的需求选择最适合的方式：

1. Makefile构建

这是最传统的构建方式，适合熟悉Unix/Linux环境的开发者：

./configure --with-openssl  # 配置构建选项
make                       # 编译项目
sudo make install          # 安装库文件

configure脚本提供了丰富的配置选项，可以通过./configure --help查看所有可用选项。

2. CMake构建

CMake是跨平台构建的首选方案，适用于各种操作系统：

mkdir build && cd build    # 创建构建目录
cmake .. -DWITH_OPENSSL=ON # 配置项目
cmake --build .           # 开始构建

3. Bazel构建

对于使用Bazel构建系统的项目，可以直接使用：

bazel build libhv

跨平台构建指南

Windows平台构建

在Windows上推荐使用CMake配合Visual Studio：

mkdir win64
cd win64
cmake .. -G "Visual Studio 17 2022" -A x64
cmake --build .

交叉编译

ARM架构交叉编译

# 安装交叉编译工具链
sudo apt install gcc-arm-linux-gnueabi g++-arm-linux-gnueabi

# 使用Makefile方式
export CROSS_COMPILE=arm-linux-gnueabi-
./configure
make clean
make libhv

# 或使用CMake方式
cmake .. -DCMAKE_C_COMPILER=arm-linux-gnueabi-gcc -DCMAKE_CXX_COMPILER=arm-linux-gnueabi-g++
cmake --build . --target libhv libhv_static

MinGW交叉编译

sudo apt install mingw-w64
export CROSS_COMPILE=x86_64-w64-mingw32-
./configure
make clean
make libhv

移动平台构建

Android平台

mkdir build
cd build
cmake .. -DCMAKE_TOOLCHAIN_FILE="$ANDROID_NDK_ROOT/build/cmake/android.toolchain.cmake" \
         -DANDROID_ABI="arm64-v8a" \
         -DANDROID_PLATFORM=android-21
cmake --build . --target hv --config Release

iOS平台

mkdir build
cd build
cmake .. -G Xcode \
         -DCMAKE_TOOLCHAIN_FILE=../cmake/ios.toolchain.cmake \
         -DPLATFORM=OS64 \
         -DARCHS="arm64" \
         -DDEPLOYMENT_TARGET=9.0
cmake --build . --target hv_static --config Release

构建目标选择

libhv支持构建不同的目标：

核心库：make libhv
示例程序：make examples
单元测试：make unittest

功能选项配置

libhv提供了丰富的功能选项，可以根据需求启用或禁用特定功能：

1. 纯C构建

如果项目不需要C++支持，可以禁用evpp模块：

./configure --without-evpp
make clean && make libhv

2. OpenSSL支持

启用SSL/TLS支持非常简单：

sudo apt install openssl libssl-dev
./configure --with-openssl
make clean && make

启用后可以使用libhv提供的SSL/TLS接口：

hssl_ctx_t hssl_ctx_new(hssl_ctx_opt_t* opt);
int hio_new_ssl_ctx(hio_t* io, hssl_ctx_opt_t* opt);

3. cURL支持

./configure --with-curl
make clean && make

4. HTTP/2支持

sudo apt install libnghttp2-dev
./configure --with-nghttp2
make clean && make

5. KCP支持

./configure --with-kcp
make clean && make

6. MQTT支持

./configure --with-mqtt
make clean && make

构建后的测试

构建完成后，可以运行示例程序进行测试：

# 启动HTTP服务器
bin/httpd -s restart -d

# 使用curl测试
bin/curl -v http://localhost:8080
bin/curl -v https://localhost:8443  # 如果启用了OpenSSL
bin/curl -v http://localhost:8080 --http2  # 如果启用了HTTP/2