高级C++分布式Actor框架Hiactor入门教程

高级C++分布式Actor框架Hiactor入门教程

hiactorHiactor is a distributed C++ actor framework.项目地址:https://gitcode.com/gh_mirrors/hi/hiactor

1. 项目目录结构及介绍

.
├── cmake                # CMake相关配置
├── codegen               # 代码生成工具
├── demos                 # 示例应用程序
├── docs                  # 文档资料
├── include/hiactor       # Hiactor核心库头文件
├── seastar               # 子模块，嵌入了Seastar库
└── src                   # 源代码
   ├── actors             # Actor实现
   ├── core                # 核心组件
   ├── network             # 网络相关的Actor
   └── utils               # 辅助工具

• codegen: 用于自动生成代码的工具
• demos: 包含示例应用，帮助理解如何使用Hiactor
• docs: 文档和说明书
• include/hiactor: 定义了Hiactor的核心接口和类
• src: 主要源代码，包括不同领域的Actor实现和核心功能
• seastar: 作为Hiactor依赖的高性能网络库Seastar，被集成在项目中

2. 项目启动文件介绍

Hiactor的启动文件没有明确指出，但通常在构建项目后，可以从build/demos或build/src目录下找到可执行文件。这些文件是编译后的示例程序或测试用例，可以作为了解框架运行方式的起点。

例如，一个可能的启动命令是：

./build/demos/hello_world

这将运行一个简单的Hello World演示，展示如何在Hiactor环境中创建和通信Actor。

3. 项目配置文件介绍

Hiactor的主要配置是在CMake时通过命令行参数指定的。这些选项允许你控制编译过程和最终生成的目标。以下是一些重要的配置变量：

• Hiactor_DEBUG: 开启调试模式，默认关闭。
• Hiactor_INSTALL: 是否安装Hiactor，默认开启。
• Hiactor_DEMOS: 是否编译和启用示例，默认开启。
• Hiactor_TESTING: 是否编译和启用单元测试，默认开启。
• Hiactor_GPU_ENABLE: 启用GPU支持（需要CUDA环境），默认关闭。
• Hiactor_DPDK: 启用DPDK支持， 默认关闭。
• Hiactor_CXX_DIALECT: 设置C++方言，如gnu++17，默认值。
• Hiactor_CXX_FLAGS: 其他编译标志。
• Hiactor_COOK_DEPENDENCIES: 是否下载并构建Seastar依赖，默认关闭。
• Hiactor_COOK_EXCLUDES: 排除的依赖项列表，仅当Hiactor_COOK_DEPENDENCIES开启时有效。
• Hiactor_CPU_STALL_REPORT: 是否开启CPU停滞警告报告，默认关闭。

例如，若要以g++ 17方言构建，且不包含示例和测试，你可以这样运行CMake：

mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local \
      -DHiactor_CXX_DIALECT=gnu++17 \
      -DHiactor_DEMOS=OFF \
      -DHiactor_TESTING=OFF ..
make
make install

以上就是对Hiactor项目的基本介绍以及配置和启动的相关说明。要深入了解和使用Hiactor，建议阅读项目文档和尝试运行提供的示例。

hiactorHiactor is a distributed C++ actor framework.项目地址:https://gitcode.com/gh_mirrors/hi/hiactor