ZSummer 项目启动与配置教程

1. 项目的目录结构及介绍

ZSummer 是一个跨平台的 C++ 高性能轻量级网络库，支持 TCP、UDP，并拥有完善的定时器机制与日志系统。项目的目录结构如下：

• depends/：存放项目依赖的库文件。
• doc/：包含项目的文档资料。
• example/：示例代码目录，展示了如何使用 ZSummer 库创建服务器和客户端。
• network/：网络库核心代码目录。
• utility/：工具类代码目录。
• .gitignore：Git 忽略文件列表。
• COPYRIGHT：版权声明文件。
• HISTORY：项目历史记录文件。
• README.md：项目说明文件。
• stats.sh：代码行数统计脚本。

2. 项目的启动文件介绍

在 example/ 目录中，提供了启动服务器和客户端的示例代码。以下是一个简单的服务器启动流程：

#include "zsummer.h"

using namespace zsummer::network;

int main() {
    // 创建 IOCP 服务
    IOService service;

    // 绑定服务器地址和端口
    EndPoint ep("0.0.0.0", 12345);

    // 创建并配置服务器
    TcpServerPtr server(new TcpServer);
    server->set_io_service(service);
    server->setEp(ep);
    server->setConnectionHandler([](const TcpConnectionPtr& conn) {
        // 处理连接事件
    });

    // 启动服务器
    server->start();

    // 运行 IOCP 事件循环
    service.run();
    return 0;
}

客户端的启动流程类似，需要创建一个 TcpClient 对象，并配置相应的连接和消息处理逻辑。

3. 项目的配置文件介绍

ZSummer 项目主要依赖于 CMake 进行编译配置。在项目根目录中，存在一个 CMakeLists.txt 文件，用于定义编译规则和依赖。

以下是一个简单的配置文件示例：

cmake_minimum_required(VERSION 2.8.12)
project(zsummer)

set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED True)

add_subdirectory(network)
add_subdirectory(example)

在 example/CMakeLists.txt 文件中，定义了如何编译示例程序：

add_executable(example_server example_server.cpp)
target_link_libraries(example_server zsummer_network)

add_executable(example_client example_client.cpp)
target_link_libraries(example_client zsummer_network)

要编译和运行示例程序，可以使用以下命令：

cd example
cmake .
make

在 Windows 平台上，可以使用 Visual Studio 打开 zsummer.sln 解决方案文件进行编译。