RubyInstaller:Windows平台上的Ruby构建系统
【免费下载链接】rubyinstaller RubyInstaller for Windows - Build recipes 项目地址: https://gitcode.***/gh_mirrors/ru/rubyinstaller
RubyInstaller是一个专门为Windows操作系统设计的Ruby构建系统,它提供了一套完整的Rake构建配方,用于下载、编译和打包Ruby解释器及其相关组件。该项目专注于简化在Windows环境下构建Ruby的过程,让开发者能够更轻松地进行Ruby开发和贡献。
项目概述
RubyInstaller项目使用3-clause Modified BSD许可证,主要目标是创建一个开发沙箱环境,使用免费的MinGW工具链来编译Ruby及其组件。该项目特别适合需要在Windows系统上构建Ruby源代码的开发者和贡献者。
注意:该项目主要支持Ruby 2.3及更早版本。对于Ruby 2.4及更新版本,建议使用RubyInstaller2项目。
核心功能特性
1. 多版本Ruby构建支持
RubyInstaller支持构建多个Ruby版本,包括:
- MRI 1.8.7(默认)
- MRI 1.9.2
- MRI 2.0.0
- MRI 2.1.x
2. DevKit工具集集成
项目包含完整的DevKit构建系统,提供:
- 编译器工具链支持(MinGW、TDM-G***等)
- 原生C扩展构建能力
- 多种打包格式(Installer、7-Zip、自解压包)
3. 灵活的构建配置
支持多种构建选项和参数配置:
- 源码检出(CHECKOUT选项)
- 本地源码构建(LOCAL选项)
- 兼容性模式(***PAT选项)
- 自定义编译器版本(DKVER参数)
项目结构组织
RubyInstaller采用清晰的目录结构来组织构建配方:
recipes/
├── ***piler/ # 编译器相关配方
├── dependencies/ # 依赖库构建配方
├── devkit/ # DevKit工具集配方
├── extract_utils/ # 压缩包提取工具
├── interpreter/ # Ruby解释器构建配方
├── packager/ # 打包工具配方
└── tools/ # 附加工具配方
快速开始使用
基本构建命令
在项目根目录下执行以下命令开始构建:
# 构建默认版本(MRI 1.8.7)
rake
# 构建特定Ruby版本
rake ruby19 # 构建MRI 1.9.2
rake ruby20 # 构建MRI 2.0.0
rake ruby21 # 构建MRI 2.1.x
# 使用特定DevKit版本构建
rake ruby21 DKVER=mingw64-32-4.7.2
DevKit构建示例
# 构建默认DevKit(TDM 4.5.2)
rake devkit
# 构建特定版本的DevKit
rake devkit DKVER=tdm-32-4.6.1
# 构建7-Zip格式的DevKit
rake devkit 7Z=1
# 构建自解压格式的DevKit
rake devkit SFX=1
支持的编译器工具链
RubyInstaller支持多种编译器工具链:
| 编译器 | 支持的DKVER值 |
|---|---|
| tdm | tdm-32-4.7.1, tdm-32-4.6.1等 |
| mingw | mingw-32-4.6.2, mingw-32-3.4.5 |
| mingw64 | mingw64-32-4.7.2, mingw64-64-4.7.2 |
| mingwbuilds | mingwbuilds-32-4.7.3, mingwbuilds-64-4.7.3 |
系统要求
要使用RubyInstaller构建系统,您需要:
- Ruby 1.9.3或更高版本(mswin32或mingw32实现)
- Zlib扩展和DLL(zlib1.dll)
- 用于构建Windows安装包的Innosetup 5.4.2
配置自定义化
项目支持通过创建override/build_config.rb文件来自定义构建配置。您可以覆盖默认的配置值,参考config/ruby_installer.rb和config/devkit.rb文件中的可配置选项。
项目贡献
RubyInstaller是一个开源项目,欢迎开发者贡献代码和改进。项目使用标准的Git工作流程,您可以通过提交Pull Request来参与项目开发。
要获取项目源码,请使用以下命令:
git clone https://gitcode.***/gh_mirrors/ru/rubyinstaller
注意事项
- 避免在包含空格的路径中运行此项目,因为MSYS环境在挂载MinGW的/etc/fstab条目时存在问题
- 对于Ruby 2.0和2.1版本,需要使用不同于默认版本的DevKit
- 项目主要支持较旧版本的Ruby,新版本建议使用RubyInstaller2
RubyInstaller为Windows平台上的Ruby开发提供了强大的构建基础设施,使得在Windows环境下编译和打包Ruby变得更加简单和高效。
【免费下载链接】rubyinstaller RubyInstaller for Windows - Build recipes 项目地址: https://gitcode.***/gh_mirrors/ru/rubyinstaller