创建并运行您的第一个 Ruby 项目
本主题说明如何在 RubyMine 中执行以下操作:
创建您的第一个空应用程序
创建并运行 Ruby 文件
创建并运行您的第一个 Rails 应用程序
向 Rails 应用程序添加 JavaScript 资源
运行添加了 JavaScript 资源的 Rails 应用程序
在执行以下过程之前,请下载并安装 Ruby 发行版 ,并设置 IDE。
我们将使用安装在 macOS 上的 RubyMine 执行所有过程。
创建您的第一个应用程序
在本章中,您将学习如何创建空应用程序、添加 Ruby 文件并运行该文件。
创建一个空应用程序
运行 RubyMine 并点击 新建项目 在 欢迎界面。

在 新建项目 对话框中,确保左侧窗格中选择了 空项目。 然后,指定以下设置:

名称 :为项目指定一个名称(在我们的示例中为 ruby_helloworld)
Location :指定您希望创建项目的目录路径。 默认情况下,RubyMine 会创建一个与项目同名的目录。
解释器 :选择系统中安装的所需 Ruby 解释器。
点击 创建 继续。
创建一个 Ruby 文件
创建项目后,您将在左侧的项目工具窗口中看到其结构。 要添加一个 Ruby 文件,请执行以下操作:
在“项目”工具窗口中选择一个项目根目录,然后按 Alt+Insert。
在调用的弹出窗口中,选择 Ruby 文件/类 并按 Enter。

在弹出的窗口中,指定脚本名称(在本例中为 script ),然后点击 确定。

在编辑器中插入以下代码:
puts "Please enter your name" name = gets.chomp puts "Hello, #{name}! I'm Ruby!"
运行 Ruby 脚本
要运行创建的脚本,请执行以下操作:
按 Ctrl 两次并输入以下命令:
ruby script.rb按下 Enter。

在运行工具窗口中,输入任意名称并按 Enter 以查看程序响应。
运行/调试配置
运行 Ruby 脚本后,RubyMine 会自动创建一个特殊的配置文件,即运行/调试配置。 此类配置文件用于运行、调试和测试应用程序,并指定脚本名称、工作目录、启动前要执行的操作等。
要编辑配置,请在 运行 小部件下调用下拉菜单并选择 编辑配置。

在弹出的 运行/调试配置 对话框中,您可以指定启动脚本所需的设置。

有关运行/调试配置的更多信息,请参阅 本主题。
创建一个 Rails 应用程序
在本章中,您将学习如何创建 Rails 应用程序并运行该应用程序。
运行 RubyMine 并点击 新建项目 在 欢迎界面。

在 新建项目 对话框中,左侧窗格 项目类型 组的 Rails 组 Ruby on Rails 中选择 应用程序 ,并指定以下设置:
指定以下设置:

名称 :为项目指定一个名称(在我们的示例中为 rails-helloworld)。
Location :指定您希望创建项目的目录路径。 默认情况下,RubyMine 会创建一个与项目同名的目录。
解释器 :选择您希望在项目中使用的 Ruby 解释器。
Rails 版本 :选择您希望在项目中使用的 Rails 版本。 如果所选解释器中未安装 Rails gem 或缺少所需的 Rails 版本,请单击字段中的
。 等待 RubyMine 下载所有可用的 Rails 版本,然后从下拉列表中选择所需版本。 点击 确定 继续。

如果所选版本尚未安装,RubyMine 会在创建项目时安装它。
额外选项 :在 额外选项 字段中提供用于项目创建的额外 Rails 选项。
例如,您可以指定通常用于附加到
rails new(新建)命令的 参数:--skip-tests(跳过测试)跳过测试文件的创建,--skip-action-mailer(跳过 Action Mailer)跳过 Action Mailer 文件,--skip-action-cable(跳过 Action Cable)跳过 Action Cable 文件,等等。要获取与所用 Rails 版本兼容的 Rails 选项的完整列表,请运行
rails new --help(帮助)命令。
点击 创建 关闭 新建项目 对话框。
RubyMine 创建一个新的 Rails 应用程序,安装 Gemfile 中提到的 gem 依赖项,并安装项目 package.json 文件中提到的 JavaScript 依赖项。 您可以在 Run 工具窗口中看到此过程。

安装所有依赖项后,您可以在左侧的 Project 工具窗口(Alt+1 )中查看项目结构。 在右侧,RubyMine 会自动在编辑器中打开主要的项目文件。

如果您的操作系统中安装了 Git,生成一个新的 Rails 应用程序时也会初始化一个 Git 仓库。 您可以从 版本控制 部分学习如何在 RubyMine 中使用版本控制系统。
现在我们有一个运行正常的 Rails 应用。 要查看其效果,您需要启动一个 web 服务器。 执行以下步骤来完成此操作:
单击右上角的 运行 图标。
RubyMine 将展示准备运行应用程序的过程。

在浏览器中打开 http://127.0.0.1:3000 ,即可查看 Rails 的默认信息页面。

向 Rails 应用程序添加 JavaScript 资源
本章说明如何向 Rails 项目添加 JavaScript 资源并运行应用程序,以查看其工作方式。 我们将使用在上一过程中创建的空 Rails 应用程序。 以下步骤假定您已经创建了 此项目 ,并已在编辑器中将其打开。
添加控制器
请按 Ctrl 两次并开始键入 controller。 在调用的列表中,选择 rails generate controller 并按 Enter。

在调用的 添加新控制器 对话框中,将控制器名称设置为 Welcome ,并添加一个名为 index的操作。 点击 确定。

RubyMine 将创建一个控制器、视图及其他几个文件。 此过程将显示在 Run 工具窗口中。 在此窗口中,点击 index.html.erb 文件。

要将应用程序的首页设置为 索引 ,请打开 config/routes.rb 文件,并在
Rails.application.routes.draw do ... end块中添加以下行:root 'welcome#index'了解更多信息,请参见 Setting the Application Home Page。
更新视图
在已创建的视图中添加一个按钮。
在 Project 视图(Alt+1 )中,打开 app/views/welcome/index.html.erb 文件。
用以下代码替换文件中现有内容:
<h1>Hello, Rails!</h1> <button id="greet-user-button">Hello!</button>除了
h1标记中的现有 static 文本外,视图文件现在还包含一个具有特定标识符、将被 JavaScript 使用的按钮元素。
添加 JavaScript 处理程序
现在,创建一个用于处理按钮点击的 JavaScript 文件。
在 Project 视图中,选择 应用/JavaScript 目录。
按 Alt+Insert 并选择 JavaScript 文件。

指定文件名称(hello ),然后按 Enter。

在创建的 hello.js 文件中,添加以下代码:
const button = document.getElementById("greet-user-button") if (button) { button.addEventListener("click", () => { alert("Hello!, JavaScript!") }) }在该脚本中:
通过标识符查找按钮。
添加点击处理程序,使其显示警告并将消息日志输出到控制台。
为了让该文件在应用程序中可用,请打开 应用/JavaScript/应用程序.js 并添加:
import "hello"请确保应用程序布局包含 JavaScript 资源。 打开 应用/视图/布局/应用程序.html.erb 并确认其包含:
<%= javascript_importmap_tags %>打开 配置/导入映射.rb 文件并添加以下行:
pin "hello"
启动网络服务器
要查看我们的应用程序运行效果,您需要启动 Web 服务器。
按 Ctrl 两次并开始键入 开发。
单击右上角的 运行 图标。
RubyMine 将展示准备运行应用程序的过程。

在浏览器中打开 http://127.0.0.1:3000 。 然后点击 您好! 按钮即可看到警告。
