使用Wasmify Rails将Rails应用打包到WebAssembly

1. 项目介绍

Wasmify Rails是一个开源项目，旨在提供工具和扩展，以便将Ruby on Rails应用程序编译到WebAssembly（Wasm）。WebAssembly是一种可以在现代浏览器中运行的低级语言，它允许开发者以接近原生速度执行代码。通过将Rails应用编译为Wasm模块，可以实现跨平台的高性能部署。

2. 项目快速启动

步骤1：环境准备

首先，确保你的系统中已经安装了以下工具：

• Ruby（推荐版本为3.3.3）
• Rails
• Node.js和npm（用于前端资源打包）

步骤2：创建新项目

在终端中执行以下命令，创建一个新的Rails项目：

rails new my_wasm_rails_app
cd my_wasm_rails_app

步骤3：添加Wasmify Rails依赖

编辑Gemfile文件，添加以下内容：

gem 'wasmify-rails', group: [:development, :wasm]

然后执行bundle install安装依赖。

步骤4：配置项目

运行以下命令以预配置项目：

bin/rails wasmify:install

此命令会创建一些配置文件，并将wasm组添加到Gemfile中。

步骤5：构建Wasm核心模块

更新Gemfile，将需要的gem标记为wasm组：

group :default, :wasm do
  gem 'rails'
  # 其他你需要的gem
end

然后构建核心Wasm模块：

bin/rails wasmify:build:core

如果构建失败，根据错误信息排除不兼容的gem，并重试构建。

步骤6：打包应用

构建成功后，执行以下命令打包整个应用：

bin/rails wasmify:pack:core

3. 应用案例和最佳实践

• 环境检查：在代码中使用Kernel#on_wasm?方法检查是否在Wasm环境中运行。
• 数据库适配：使用sqlite3_wasm、pglite或nulldb适配器以支持不同的数据库需求。
• 文件处理：利用Active Storage的null变种处理器，处理文件存储需求。
• 邮件发送：使用null邮件发送方式，在Wasm环境中禁用邮件发送。

4. 典型生态项目

目前，Wasmify Rails生态系统中的项目包括但不限于以下几种：

• 前端集成：通过Vite PWA应用启动器，将Rails后端与前端集成。
• 数据库支持：支持多种数据库适配器，包括SQLite、PostgreSQL等。
• 测试工具：为Wasm环境提供特定的测试适配器，如nullldb。

通过遵循这些步骤和最佳实践，开发者可以开始将Rails应用程序部署到WebAssembly，从而充分利用其在性能和跨平台支持方面的优势。