Basketo 的安装和配置教程

2025-05-28 12:25:58作者：齐冠琰

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 系统上的安装步骤

克隆仓库：

git clone --recurse-submodules git@github.com:basketoengine/Basketo.git
cd Basketo

创建构建目录并运行 CMake：
```
mkdir build && cd build
cmake ..
```
编译项目：
```
make -j $(nproc)
```
运行引擎：
```
./BasketoGameEngine
```
如果您想运行物理测试，请使用以下命令：
```
./PhysicsTest
```

Windows 系统上的安装步骤

安装 Visual Studio 2022（社区版或更高版本），并安装以下工作负载：
- 桌面开发（使用 C++）
- C++ CMake 工具
- Windows 10 或 11 SDK
安装 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
```

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

git clone --recurse-submodules git@github.com:basketoengine/Basketo.git
cd Basketo
mkdir build && cd build

使用 CMake 配置项目：

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

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

构建项目：
```
cmake --build . --config Release
```

运行引擎：

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

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

./PhysicsTest.exe

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

登录后查看全文