ECS 框架使用教程

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

ecs-framework/
├── docs/
│   └── README.md
├── examples/
│   ├── basic/
│   └── advanced/
├── src/
│   ├── components/
│   ├── systems/
│   └── main.cpp
├── tests/
│   └── test_main.cpp
├── CMakeLists.txt
└── README.md

• docs/: 包含项目的文档文件，如 README.md。
• examples/: 包含项目的示例代码，分为 basic 和 advanced 两个子目录。
• src/: 项目的源代码目录，包含 components、systems 和 main.cpp。
• tests/: 包含项目的测试代码，如 test_main.cpp。
• CMakeLists.txt: 用于构建项目的 CMake 配置文件。
• README.md: 项目的主 README 文件。

2. 项目的启动文件介绍

项目的启动文件位于 src/main.cpp。该文件主要负责初始化 ECS 框架，并启动游戏循环。以下是 main.cpp 的基本结构：

#include "ecs/ecs.h"

int main() {
    // 初始化 ECS 框架
    ecs::initialize();

    // 创建实体和组件
    auto entity = ecs::create_entity();
    entity.add_component<PositionComponent>(0, 0);

    // 运行游戏循环
    while (true) {
        ecs::update();
    }

    // 清理资源
    ecs::shutdown();
    return 0;
}

3. 项目的配置文件介绍

项目的配置文件通常位于项目的根目录下，命名为 config.json 或 config.yaml。以下是一个示例 config.json 文件：

{
    "window": {
        "width": 800,
        "height": 600,
        "title": "ECS Framework"
    },
    "logging": {
        "level": "info"
    },
    "resources": {
        "texture_path": "assets/textures",
        "sound_path": "assets/sounds"
    }
}

• window: 配置游戏窗口的宽度和高度，以及标题。
• logging: 配置日志记录的级别。
• resources: 配置资源文件的路径，如纹理和声音文件的路径。

以上是 ECS 框架的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些内容能帮助你更好地理解和使用该框架。