Setting up MacRuby

Watson1978 edited this page Jan 28, 2013 · 7 revisions


The list below describes the requirements for developing an application with MacRuby.

  • OSX 10.6.8 (Snow Leopard) or later
  • Xcode 4.2 or Xcode 4.3
  • MacRuby
  • BridgeSupport Preview 3 (necessary if you don't run OSX 10.7 Lion)

Install Xcode

You can install Xcode from the Mac App Store. Launch the Mac App Store application. After that, type "Xcode" in the search field on top right corner.


Xcode will appear in the search results. Click on the button to install it.


If you run OSX 10.6.8, Xcode 4.2.x will be installed. And if you use Mac OS X 10.7.x, Xcode 4.3.x will be installed.

If you had previously installed an older version of Xcode (such as 4.2.x) and just installed 4.3, we recommend that you run the following command in the Terminal.

$ sudo xcode-select -switch /Applications/

Install the Command Line Tools

Since Xcode 4.3, command line tools (such as the compiler, etc) are shipped as part of an additional package. You should install this package.

  1. Open Xcode and go to the Preferences window.
  2. Go to the Downloads tab, and install the Command Line Tools package from there.


Install MacRuby

Next step, we install MacRuby.

The latest version of MacRuby is 0.12. However, and unfortunately, support for Xcode 4.3 has not been integrated in a release yet. Therefore, you must install one of the nightly builds from Nightly builds always have latest changes.


IMPORTANT: If you replace (update via Mac App Store), need to reinstall MacRuby.

Install BridgeSupport Preview 3

** OS X 10.6.8 users (only)** will have to install BridgeSupport Preview 3. BridgeSupport is used to get information about the public frameworks APIs of OSX. In OSX 10.7, it is already pre-installed. You can get BridgeSupport Preview 3 from, download the BridgeSupport Preview file.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.