Basketo 的安装和配置教程

1. 项目基础介绍和主要编程语言

Basketo 是一个开源的2D游戏引擎项目，致力于为游戏开发者提供轻量级且高效的解决方案。该项目由 basketoengine 维护，并且正在积极开发中。Basketo 引擎支持跨平台，并且计划集成 AI 功能，使其成为一个 AI-原生的游戏引擎。项目的主要编程语言是 C++，此外也使用了 C、CMake 和 Lua 语言。

2. 项目使用的关键技术和框架

Basketo 引擎使用以下关键技术和框架：

• C++：作为主要的开发语言，用于实现游戏引擎的核心功能。
• SDL2：Simple DirectMedia Layer 是一个跨平台的开源库，用于开发多平台的多媒体应用。
• SDL2_image：用于加载和保存图片的库，是 SDL2 的扩展。
• SDL2_ttf：用于处理 TrueType 字体的库，允许在游戏引擎中渲染文字。
• SDL2_mixer：用于音频播放的库，可以播放多种格式的音频文件。
• Lua：作为脚本语言，用于游戏逻辑和引擎配置。

3. 项目安装和配置的准备工作与详细安装步骤

准备工作

在安装 Basketo 引擎之前，您需要确保以下依赖项已经安装在您的系统上：

• CMake：版本至少为 3.26.0 的 CMake 工具。
• SDL2/SDL2_image/SDL2_ttf/SDL2_mixer：这些是游戏引擎运行必需的库。
• Lua：版本至少为 5.4 的 Lua 解释器。
• g++：支持 C++17 标准的 g++ 编译器。

安装步骤

Linux 系统上的安装步骤

1. 克隆仓库：

   git clone --recurse-submodules [e-mail]:basketoengine/Basketo.git
   cd Basketo
   

2. 创建构建目录并运行 CMake：

   mkdir build && cd build
   cmake ..
   

3. 编译项目：

   make -j $(nproc)
   

4. 运行引擎：

   ./BasketoGameEngine
   

   如果您想运行物理测试，请使用以下命令：

   ./PhysicsTest
   

Windows 系统上的安装步骤

1. 安装 Visual Studio 2022（社区版或更高版本），并安装以下工作负载：

   • 桌面开发（使用 C++）
   • C++ CMake 工具
   • Windows 10 或 11 SDK

2. 安装 CMake 和 vcpkg：

   • CMake 可以随 Visual Studio 一起安装或从 CMake 官网下载。

   • 使用以下命令克隆 vcpkg 并安装依赖：

     git clone https://github.com/microsoft/vcpkg.git
     cd vcpkg
     bootstrap-vcpkg.bat
     vcpkg install sdl2 sdl2-image sdl2-ttf sdl2-mixer lua
     

3. 克隆 Basketo 仓库并创建构建目录：

   git clone --recurse-submodules [e-mail]:basketoengine/Basketo.git
   cd Basketo
   mkdir build && cd build
   

4. 使用 CMake 配置项目：

   cmake .. -DCMAKE_TOOLCHAIN_FILE=C:/path/to/vcpkg/scripts/buildsystems/vcpkg.cmake -DCMAKE_BUILD_TYPE=Release
   

   请将 "C:/path/to/vcpkg" 替换为您 vcpkg 目录的完整路径。

5. 构建项目：

   cmake --build . --config Release
   

6. 运行引擎：

   从 build/Release 目录运行 ./BasketoGameEngine.exe
   

   如果您想运行物理测试，请运行：

   ./PhysicsTest.exe
   

以上步骤为您提供了从零开始安装和配置 Basketo 游戏引擎的详细指南。按照这些步骤操作后，您应该能够成功运行 Basketo 引擎。