RubyMotionBuilder for Sublime Text 2 and 3

This plugin provides some features that simplify RubyMotion developing in Sublime Text 2 and 3.

• RubyMotion syntax

  It will work with RubyMotion project related *.rb and Rakefile. Code completion and Build system don't work in pure Ruby editing.

• Code completion

  It is same as RubyMotionSublimeCompletions. The only difference is syntax scope.

• Build system (only work with RubyMotion)

  Provides build system for RubyMotion. Supports four commands, Build, Clean, Run and Deploy. Run kick Terminal.app automatically.

Package Control Installation

note: This step requires Package Control.

1. Open the Command Palette using [command + shift + p] and enter "install package".
2. Select Package Control: Install Package from the popup menu and press [enter / return]
3. Enter "RubyMotionBuilder" and press [enter / return]

Manual Installation

Put this package into your Sublime Text 2 or 3 packages folder:

• 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

Set up

First, RubyMotionBuilder requires PATH environment variable to run Build and some commands. Mountain Lion or later users can configure variable via /etc/launchd.conf like

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

(Older Mac OS X users can configure using ~/.MacOSX/environment.plist)

Then, reboot your Mac.

Usage

Table of default key bind

Functions	Key bind
Build	command + b
Run	command + r
Run Spec	command + option + r
Deploy	command + option + b
Run from list	command + option + l
Set Breakpoint	control + option + b
Show reference	control + option + d

RubyMotion syntax

1. Open *.rb or Rakefile in your RubyMotion project
2. You can see the "RubyMotion" on status bar in right bottom corner. Otherwise, it's not working. If Sublime Text cache keep syntax as "Ruby", please close and open the file.

note: RubyMotion detection rule is project's Rakefile contains "Motion", or not.

Code completion

1. Inside your RubyMotion project just start typing the name of a method and the autocomplete window will pop up.
2. Press enter / return to trigger the completion.

Build

1. Verify that Tools -> Build System is set to Automatic.
2. Open *.rb or Rakefile in your RubyMotion project and press [command + b].
3. Wait for the console to notify you the message "[Finished]".
4. If you get a error, you can jump to it with press [F4]

note: Default target is Simulator. If you want to change the target, please edit "RubyMotion.sublime-build".

Clean

1. Open the Command Palette using [command + shift + p] and press "clean".
2. Select RubyMotionBuilder: Clean from the popup menu and press [enter / return].
3. Wait for the console to notify you the message "[Finished]".

Run

1. Open *.rb or Rakefile in your RubyMotion project and press [command + r]. If you want to enable retina, please press [shift + command + r].
2. Wait for the Terminal.app will kick Simulator.
3. If you want to modify code and to try again, just re-press [command + r]. Then, automatically post "quit" to Terminal.app and re-execute "rake".

note: Goto symbol was assigned to [control + r]

Run Spec

1. Open *.rb or Rakefile in your RubyMotion project and press [command + option + r].
2. Wait for the Terminal.app will kick Simulator.
3. If you want to modify code and to try again, just re-press [command + option + r]. Then, automatically post "quit" to Terminal.app and re-execute "rake spec".

Deploy

1. Open *.rb or Rakefile in your RubyMotion project and press [command + option + b].
2. Wait for the console to notify you the message "[Finished]".

Run commands from Rake task list

1. Open *.rb or Rakefile in your RubyMotion project and press [command + option + l].
2. Select a task from displayed list.

Set break point for debugging

1. Open *.rb or Rakefile in your RubyMotion project.
2. Move a text cursor in where set a breakpoint and [control + option + b]. Then, the breakpoint was described in debugger_cmds like b app_delegate.rb:7

Show reference documents using Dash app

1. Open *.rb or Rakefile in your RubyMotion project.
2. Select a word (like method) and press [control + option + d].

Completions generator

The command is supported in command palette.

• RubyMotionBuilder: Generate completions will generate completions from BridgeSupport files of RubyMotion.

Configuration

Switch Terminal

1. Open *.rb or Rakefile in your RubyMotion project
2. Open [Sublime Text]->[Preferences]->[Settings - More]->[Syntax Specific - User] in Sublime Text menu.
3. Configure "terminal" setting to switch terminal application to build app. The following settings switch terminal to "iTerm" (By default, "Terminal").

{
	"terminal": "iTerm"
}

Disable to activate Terminal

1. Open *.rb or Rakefile in your RubyMotion project
2. Open [Sublime Text]->[Preferences]->[Settings - More]->[Syntax Specific - User] in Sublime Text menu.
3. Configure "activate_terminal" setting to disable terminal activation. The following settings disable terminal activation (By default, true).

{
	"activate_terminal": false
}

Disable auto-save

When you would run app through this plugin, the plugin will save changed files. You could disable this feature.

1. Open *.rb or Rakefile in your RubyMotion project
2. Open [Sublime Text]->[Preferences]->[Settings - More]->[Syntax Specific - User] in Sublime Text menu.
3. Configure "auto_save" setting to disable auto-save feature (By default, true).

{
	"auto_save": false
}

LICENSE

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.