EmulationStation 安装与配置指南

EmulationStation 安装与配置指南

EmulationStation A Fork of Emulation Station for RetroPie. Emulation Station is a flexible emulator front-end supporting keyboardless navigation and custom system themes. 项目地址: https://gitcode.com/gh_mirrors/emu/EmulationStation

EmulationStation 是一个跨平台的图形前端，用于模拟器，支持控制器导航。本项目是一个 RetroPie 平台的 EmulationStation 分支。它主要用于 RetroPie 设备，但也可以在其他兼容的设备上运行。该项目主要使用 C++ 编程语言。

项目基础介绍

EmulationStation 旨在提供一个用户友好的界面，用于浏览和启动各种模拟器游戏。它支持多种控制器，无需键盘即可导航。此外，EmulationStation 还支持自定义系统主题，让用户可以根据个人喜好进行界面定制。

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

• C++11: 项目使用 C++11 的一些特性，因此需要较新版本的编译器。
• CMake: 用于生成 Makefile，方便跨平台编译。
• SDL2: Simple DirectMedia Layer，提供低级别访问音频、键盘、鼠标、操纵杆和图形硬件的接口。
• FreeImage: 支持流行的图形图像格式的库。
• FreeType: 用于渲染字体。
• LibVLC: 用于播放视频预览。
• RapidJSON: 提供快速的 JSON 解析器/生成器。

项目安装和配置的准备工作

在开始安装之前，请确保您的系统已经安装了以下依赖项：

• CMake
• SDL2
• FreeImage
• FreeType
• LibVLC
• cURL
• RapidJSON

Linux 系统的准备工作

对于 Debian/Ubuntu 系统的用户，可以使用以下命令安装依赖项：

sudo apt-get install libsdl2-dev libfreeimage-dev libfreetype6-dev libcurl4-openssl-dev rapidjson-dev \
libasound2-dev libgles2-mesa-dev build-essential cmake fonts-droid-fallback libvlc-dev \
libvlccore-dev vlc-bin

对于 Fedora 用户，可以使用以下命令安装依赖项：

sudo dnf install SDL2-devel freeimage-devel freetype-devel curl-devel \
alsa-lib-devel mesa-libGL-devel cmake \
vlc-devel rapidjson-devel

Windows 系统的准备工作

Windows 用户需要安装 Visual Studio 2022 和 CMake。此外，还需要安装 vcpkg 和 NuGet，以及以下库：

• LibVLC
• cURL
• FreeImage
• FreeType
• SDL2
• RapidJSON

详细安装步骤

1. 克隆项目仓库：

git clone --recursive https://github.com/RetroPie/EmulationStation.git

2. 切换到项目目录：

cd EmulationStation

3. 使用 CMake 生成 Makefile：

cmake .

4. 构建项目：

make

如果需要在调试模式下构建，请在生成 Makefile 时使用以下命令：

cmake -DCMAKE_BUILD_TYPE=Debug .

5. （可选）对于 Raspberry Pi 用户，可能需要添加特定的编译选项：

• 如果使用的是旧版/Broadcom 驱动，在运行 cmake 之前安装 libraspberry-dev 包。
• 如果使用的是 Mesa VC4/V3D GL 驱动，在编译选项中添加 -DUSE_MESA_GLES=On。
• 对于 Raspberry Pi 4，-DUSE_MESA_GLES=On 选项是必须的。

6. 将编译好的 EmulationStation 文件复制到目标文件夹，并确保所需的资源文件也在同一目录下。

完成以上步骤后，您应该能够在您的设备上启动 EmulationStation，并开始享受游戏了。

EmulationStation A Fork of Emulation Station for RetroPie. Emulation Station is a flexible emulator front-end supporting keyboardless navigation and custom system themes. 项目地址: https://gitcode.com/gh_mirrors/emu/EmulationStation