Rubyboy 安装与配置指南

1. 项目基础介绍

Rubyboy 是一个使用 Ruby 编写的 Game Boy 模拟器。Game Boy 是任天堂推出的一款经典掌机游戏平台，而 Rubyboy 旨在通过现代编程语言重新实现这一平台的模拟功能。该项目是一个开源项目，允许用户和开发者自由地使用、修改和分享。

主要编程语言：Ruby

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

• WebAssembly (WASM): Rubyboy 利用 WebAssembly 技术来提升模拟器的性能，使其能够在网页浏览器中运行。
• SDL2: Simple DirectMedia Layer 是一个跨平台的开源库，用于开发高性能的多媒体应用。
• YJIT: Ruby 3.3.x 版本中引入的一种即时编译器，可以显著提高 Ruby 代码的执行效率。

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

准备工作

-Ruby 3.2.0 或更高版本（推荐使用 Ruby 3.3.x 并启用 YJIT 以获得更好的性能）。

• 安装必要的 Ruby gems：ffi 和 rubyboy。
• 如果你的系统尚未安装 Ruby，请访问 Ruby 官方网站下载并安装。
• 确保你的系统中安装有 Git。

安装步骤

1. 克隆项目到本地：

git clone https://github.com/sacckey/rubyboy.git
cd rubyboy

2. 使用 Bundler 安装项目依赖：

bundle install

如果你没有使用 Bundler 来管理项目依赖，可以单独安装所需的 gems：

gem install ffi
gem install rubyboy

3. 配置环境变量以启用 YJIT（如果你使用的是 Ruby 3.3.x）：

export RUBYOPT=--yjit

4. 运行模拟器：

rubyboy path_to_your_rom.gbc

替换 path_to_your_rom.gbc 为你的 Game Boy ROM 文件的实际路径。

请注意，由于本指南面向小白级用户，确保在操作过程中每一步都有明确的指示，并且可能需要在终端或命令行环境中执行上述命令。如果在安装或配置过程中遇到任何问题，可以查看项目的 README 文件或访问官方文档获取更多帮助。