RubyMotionBuilder for Sublime Text 2和3

此插件提供了一些功能，以简化Sublime Text 2和3中的RubyMotion开发。

• RubyMotion语法

  它可以与与RubyMotion项目相关的*.rb和Rakefile配合使用。纯Ruby编辑中不支持代码补全和构建系统。

• 代码补全

  它与RubyMotionSublimeCompletions相同。唯一区别是语法范围。

• 构建系统（仅限RubyMotion使用）

  提供RubyMotion的构建系统。支持四个命令：Build、Clean、Run和Deploy。在执行Run时将自动启动Terminal.app。

包控制安装

注意：此步骤需要包控制。

1. 使用[command + shift + p]打开命令面板，并输入“install package”。
2. 从弹出菜单中选择Package Control: Install Package，然后按[enter / return]
3. 输入“RubyMotionBuilder”，然后按[enter / return]

手动安装

将此包放入您的Sublime Text 2或3的软件包文件夹

• Sublime Text 2

% git clone https://github.com/RubyMotionJP/SublimeRubyMotionBuilder.git ~/Library/Application\ Support/Sublime\ Text\ 2/Packages/RubyMotionBuilder

• Sublime Text 3

% git clone https://github.com/RubyMotionJP/SublimeRubyMotionBuilder.git ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/RubyMotionBuilder

设置

首先，RubyMotionBuilder需要设置环境变量PATH以运行Build和其他一些命令。Mountain Lion或更高版本的用户可以通过/etc/launchd.conf配置变量，如下所示

$ echo "setenv PATH $PATH" | sudo tee -ai /etc/launchd.conf

（较老的Mac OS X用户可以使用~/.MacOSX/environment.plist进行配置）

然后，重新启动您的Mac。

用法

默认快捷键表

RubyMotion语法

1. 在您的RubyMotion项目中打开 *.rb 或 Rakefile
2. 您可以在状态栏的右下角看到“RubyMotion”。如果没有显示，则表示没有正常工作。如果Sublime Text缓存保留语法为“Ruby”，请关闭并重新打开文件。

注意： RubyMotion检测规则是项目的Rakefile中是否包含“Motion”。

代码补全

1. 在您的RubyMotion项目中，只需开始键入一个方法的名称，自动完成窗口就会出现。
2. 按 enter / return 触发完成。

构建

1. 请确保工具 -> 构建系统设置为自动。
2. 在您的RubyMotion项目中打开 *.rb 或 Rakefile，并按 [command + b]。
3. 等待控制台显示“[完成]”消息。
4. 如果您遇到错误，可以通过按 [F4] 跳转到错误。

注意： 默认目标是模拟器。如果您想更改目标，请编辑“RubyMotion.sublime-build”。

清理

1. 使用 [command + shift + p] 打开命令面板，并按“clean”。
2. 从弹出菜单中选择 RubyMotionBuilder: Clean，并按 [enter / return]。
3. 等待控制台显示“[完成]”消息。

运行

1. 在您的RubyMotion项目中打开 *.rb 或 Rakefile，并按 [command + r]。如果要启用retina，请按 [shift + command + r]。
2. 等待Terminal.app启动模拟器。
3. 如果您要修改代码并再次尝试，只需重新按 [command + r]。然后，自动向Terminal.app发送“quit”命令并重新执行“rake”。

注意： 跳转到符号 被分配为 [control + r]

运行Spec

1. 在您的RubyMotion项目中打开 *.rb 或 Rakefile，并按 [command + option + r]
2. 等待Terminal.app启动模拟器。
3. 如果您要修改代码并再次尝试，只需重新按 [command + option + r]。然后，自动向Terminal.app发送“quit”命令并重新执行“rake spec”。

部署

1. 在您的RubyMotion项目中打开 *.rb 或 Rakefile，并按 [command + option + b]
2. 等待控制台显示“[完成]”消息。

从Rake任务列表中运行命令

1. 在您的RubyMotion项目中打开 *.rb 或 Rakefile，并按 [command + option + l]
2. 从显示的列表中选择一个任务。

设置断点进行调试

1. 在您的RubyMotion项目中打开 *.rb 或 Rakefile。
2. 将文本光标移至设置断点的位置，并按 [control + option + b]。然后，断点将在 debugger_cmds 中被描述，例如 b app_delegate.rb:7

使用Dash应用程序显示参考文档

1. 在您的RubyMotion项目中打开 *.rb 或 Rakefile。
2. 选择一个词（如方法），并按 [control + option + d]

完成生成器

此命令在命令面板中受支持。

• RubyMotionBuilder: Generate completions 将从RubyMotion的BridgeSupport文件中生成完成项。

配置

切换终端

1. 在您的RubyMotion项目中打开 *.rb 或 Rakefile
2. 在Sublime Text菜单中打开 [Sublime Text]->[偏好设置]->[设置 - 更多]->[语法特定 - 用户]。
3. 配置“terminal”设置以切换构建应用程序的终端应用程序。以下设置将终端切换到“iTerm”（默认为“Terminal”）。

{
    "terminal": "iTerm"
}

禁用以激活终端

1. 在您的RubyMotion项目中打开 *.rb 或 Rakefile
2. 在Sublime Text菜单中打开 [Sublime Text]->[偏好设置]->[设置 - 更多]->[语法特定 - 用户]。
3. 配置“activate_terminal”设置以禁用终端激活。以下设置将禁用终端激活（默认为true）。

{
    "activate_terminal": false
}

禁用自动保存

当您通过此插件运行应用程序时，插件将保存更改的文件。您可以选择禁用此功能。

1. 在您的RubyMotion项目中打开 *.rb 或 Rakefile
2. 在Sublime Text菜单中打开 [Sublime Text]->[偏好设置]->[设置 - 更多]->[语法特定 - 用户]。
3. 配置“auto_save”设置以禁用自动保存功能（默认为true）。

{
    "auto_save": false
}

许可协议

Copyright (c) 2012, 2013 Kentaro Hara
Copyright (c) 2014 RubyMotionJP

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.