RubyInstaller 技术文档

一、安装指南

系统要求

• 操作系统：Windows
• Ruby版本：2.3或更早版本（对于2.4及更高版本，请使用RubyInstaller2）

安装步骤

1. 确保您的系统中已安装Ruby，建议使用当前稳定的One-Click Installer版本。

2. 下载RubyInstaller项目的源代码。

3. 打开命令提示符，并使用cd命令切换到项目根目录。

4. 根据需要构建的Ruby版本，执行以下命令之一：

   rake          # 构建MRI 1.8.7
   rake ruby19   # 构建MRI 1.9.2
   rake ruby20   # 构建MRI 2.0.0
   rake ruby21   # 构建MRI 2.1.x
   

   对于ruby20和ruby21版本，需要使用不同的DevKit版本。

5. 如果需要指定DevKit版本，可以在命令中添加DKVER参数，例如：

   rake ruby21 DKVER=mingw64-32-4.7.2
   

二、项目使用说明

本项目提供了一套Rake构建脚本，用于下载和配置MinGW工具链，从而在Windows系统上编译Ruby解释器和其核心组件。

构建步骤

1. 确保网络连接正常。
2. 打开命令提示符，切换到项目根目录。
3. 执行相应的Rake任务，例如：

   rake ruby19
   

目录结构

• compiler/*.rake：下载和准备编译Ruby解释器所需的MinGW编译器。
• dependencies/*.rake：下载和编译Ruby解释器运行所需的各种依赖。
• devkit/*.rake：下载和构建用于编译原生C扩展的DevKit。
• extract_utils/*.rake：用于其他核心构建任务的基础存档提取工具。
• interpreter/*.rake：构建Matz的Ruby解释器。
• packager/*.rake：生成Windows安装程序包。
• tools/*.rake：安装其他附加组件。

三、项目API使用文档

本项目不直接提供API，它主要是一套用于构建Ruby解释器和相关组件的工具链。

四、项目安装方式

本项目主要通过命令行和Rake任务进行安装和构建。具体步骤如下：

1. 下载项目源代码。
2. 打开命令提示符，切换到项目根目录。
3. 执行以下Rake任务之一，根据需要构建的Ruby版本：

   rake
   rake ruby18
   rake ruby19
   rake ruby20
   rake ruby21
   

4. 根据需要，可以通过添加参数来指定不同的构建选项，例如DevKit版本。

请注意，本项目的构建过程可能需要额外的依赖和工具，如MinGW和Innosetup。请确保在开始构建之前已正确安装所有必需的组件。