libirc

Integrated-remote-console client libraries

windows部署环境

1、编译需要visual studio + cmake + openssl + boost源码（也可以使用预编译版组织目录）

1.1 例子使用的环境visual studio2022 + boost_1_87_0 + cmake 4.0.1 + openssl 3.5.0

部署完环境，按照实际的路径修改配置config.ini； 将boost源码解压到.\boost_src目录，确保解压后目录存在.\boost_src\bootstrap.bat； 然后执行build.bat即可； 测试工具的可执行文件在bin目录里面； 我们提供的API会以静态库形式，在libs目录下生成。

2、本API开发说明

    src目录存放的是API的所有代码
    test目录存放的是API的测试代码，按照模块区分

3、部署指引

    libirc库部署指引

3.1 部署概况：

3.1.1 依赖工具

    1、boost
    说明：建议最低使用1.82.0版本，项目下的构建工具可以自动构建boost。
    指引中的例子使用的是boost 1.87.0版本。
    下载地址：https://archives.boost.io/release/1.87.0/source/boost_1_87_0.7z

    2、Visual Studio
    说明：因为项目需要使用C++14标准的STL特性，建议使用Visual Studio 2017或更高版本（社区发行版即可）。
    本例使用Visual Studio 2022社区版。
    下载地址：https://visualstudio.microsoft.com/zh-hans/vs/?a=10

    3、cmake
    说明：需要最低3.15的版本。
    下载地址：https://cmake.org/

    4、openssl
    说明：需要满足对应的boost所需要的openssl版本要求。建议使用openssl 3.2.0或更高版本。。
    下载地址：https://slproweb.com/download/Win64OpenSSL-3_5_0.exe

3.1.2 设置boost源码目录

    1、解压boost_1_87_0.7z到libirc的代码根目录下;
    2、修改libirc目录下的boost_1_87_0解压目录的名字为：boost_src；
    3、当执行build.bat（构建脚本）后，会根据boost_src生成boost目录。

3.1.3 配置文件config.ini

    1、目的是让libirc能通过配置的路径找到编译器、openssl的路径以及generator的版本等信息，以免更为繁琐的环境变量设置。
    2、配置字段含义：
    C_COMPILER				# C编译器的路径
    CXX_COMPILER			# C++编译器的路径
    OPENSSL_ROOT_DIR		# OPENSSL的根目录
    OPENSSL_INC			    # OPENSSL的头文件目录
    OPENSSL_LIB			    # OPENSSL的库目录，需要包含crypto ssl等静态库
    GENERATOR				# CMAKE项目生成器工具

3.1.4 构建工具build.bat

    当依赖的环境部署完毕后，开发者可以直接在命令行运行build.bat即可。
    执行后的目录结构如下：
    .
    |-- bin                             # example中给出的例子的二进制库文件目录（生成）
    |-- boost                           # 依据boost_src中的源码生成的boost安装目录（生成）
    |-- boost_src                       # 存放boost源码（部署时，手动构建）
    |-- build                           # CMake的项目构建目录（生成）
    |-- example                         # 本项目给出的例子
    |-- libs
    |   |-- Release
    |   |   |-- irc.lib                 # irc静态库，开发者可依赖该库做二次开发（生成）
    |-- src
    |   |-- AuthClient                  # 认证功能
    |   |-- Image                       # 图像相关
    |   |-- Message                     # 报文相关
    |   |-- Public                      # 工具库，通用方法
    |   |-- Settings                    # 系统启动项设置
    |   |-- WebSocketClient             # 实现KVM客户端websocket连接
    |   |-- CMakeLists.txt
    |   |-- KvmClient.cpp               # KVM独立客户端接口定义
    |   |-- KvmClient.hpp
    |-- .gitignore
    |-- 部署指引.docx
    |-- build.bat                       # 构建工具（在命令行手动执行）
    |-- CMakeLists.txt
    |-- config.ini                      # 依赖工具路径配置（需要手动设置）
    |-- LICENSE
    |-- README.md

3.2 部署详细过程：

    部署详情可以clone项目到本地查看《部署指引.docx》