rb2exe 项目使用教程

1. 项目介绍

rb2exe 是一个开源项目，旨在将 Ruby 脚本转换为可移植的可执行应用程序。通过 rb2exe，开发者可以将 Ruby 脚本打包成独立的可执行文件，方便在没有 Ruby 环境的机器上运行。rb2exe 支持多种平台，包括 macOS、Linux 和 Windows。

2. 项目快速启动

安装

首先，确保你已经安装了 Ruby 环境。然后，使用以下命令安装 rb2exe：

gem install rb2exe

使用

以下是一个简单的示例，展示如何将 Ruby 脚本转换为可执行文件：

# 创建一个简单的 Ruby 脚本
echo "puts 'Hello world'" > test.rb

# 使用 rb2exe 将脚本转换为可执行文件
rb2exe test.rb -o test

# 运行生成的可执行文件
./test

常用选项

• -q, --quiet: 静默模式，不输出详细信息。
• -a, --add=FOLDER: 添加整个文件夹。
• -i, --ignore-folder=FOLDER: 忽略指定文件夹。
• -o, --output=OUTPUT: 指定输出可执行文件的名称。
• -d, --daemon: 以守护进程模式运行应用。
• -r, --rails: 支持 Rails 项目。
• -t, --target=[osx|l32|l64|win]: 指定目标平台。

3. 应用案例和最佳实践

案例一：多源项目

假设你有一个包含多个 Ruby 文件的项目，可以使用以下命令将其打包成一个可执行文件：

mkdir test
cd test
echo "STR = 'Hello world'" > a.rb
echo "load 'a.rb'" > main.rb
echo "puts STR" >> main.rb

rb2exe main.rb --add=. -o main

./main

案例二：Gemfile 支持

如果你的项目依赖于 Gemfile，rb2exe 也能处理：

mkdir test
cd test
echo "source 'https://rubygems.org'" > Gemfile
echo "gem 'faker'" >> Gemfile
echo "require 'faker'" > a.rb
echo 'puts "Hello #{Faker::Name.name}"' >> a.rb

rb2exe a.rb --add=. -o a

./a

最佳实践

• 代码保护: 由于 rb2exe 不会加密或混淆源代码，建议在分发可执行文件时，仅包含必要的文件，避免泄露敏感代码。
• 平台选择: 根据目标用户的环境选择合适的平台（如 macOS、Linux、Windows）。

4. 典型生态项目

rb2exe 可以与以下项目结合使用，提升开发效率：

• Rails: 支持将 Rails 项目打包成可执行文件，方便部署和分发。
• Bundler: 自动处理 Gemfile 中的依赖，确保生成的可执行文件包含所有必要的库。
• Guard: 在开发过程中，使用 Guard 自动检测文件变化并重新生成可执行文件，提高开发效率。

通过以上步骤，你可以轻松地将 Ruby 脚本转换为可执行文件，并应用于各种场景。