Mac Installation Guide

From Rubygame

Contents 1 Easy Install 2 More Difficult Install 2.1 Installing Xcode 2.2 Installing dependencies... 2.2.1 ...with Fink 2.2.2 ...with Darwinports 2.3 Installing rsdl 2.4 Installing Rubygame 2.5 Running an application

Easy Install

If you have an Intel Mac (any Mac from 2007 or newer) and are using the default version of Ruby that comes with Mac OS X, try out the Rubygame Mac Pack for a really easy install!

More Difficult Install

If you have a PowerPC Mac (older than 2007) or are using a non-default version of Ruby, you will need to compile Rubygame's dependencies yourself, or ask nicely in the forums or IRC channel for someone to do it for you.

Note: Due to a limitation in SDL, Rubygame does not work on JRuby on Macs, sorry.

Installing Xcode

Rubygame does not need to be compiled anymore (since version 2.6), but you will need to install the Xcode development tools in order to install the dependencies with Fink or Darwinports, as well as to compile rsdl.

You can find Xcode on your Mac OS X installation disc. Or, you can download Xcode online. You must register for a (free) Mac developer account for this.

• Mac OS X 10.5 (Leopard) and 10.6 (Snow Leopard): Xcode 3.1
• Mac OS X 10.3 (Panther) and 10.4 (Tiger): Xcode 2.5

Installing dependencies...

You have two options for installing the software libraries that Rubygame depends on: Fink or Darwinports. Which option you choose is just a matter of preference.

...with Fink

1. Install Fink and update to the latest version.
2. Open a new terminal (can be found in /Applications/Utilities).
3. Install SDL: sudo apt-get install sdl
4. (Optional, but highly recommended:) Install the SDL companion libraries: sudo apt-get install sdl-gfx13 sdl-image sdl-mixer sdl-ttf

Thanks to Matt Crinklaw for these instructions.

...with Darwinports

1. Install Darwinports (you must register first).
2. Open a new terminal (can be found in /Applications/Utilities).
3. Install SDL: sudo port install libsdl
4. (Optional, but highly recommended:) Install the SDL companion libraries: sudo port install libsdl_gfx libsdl_image libsdl_mixer libsdl_ttf

Thanks to Raffael Mancini (sepisultrum) for these instructions.

Installing rsdl

In order to use Rubygame applications on Mac OS X, you must use a special wrapper for the Ruby interpreter, called rsdl.

1. Get rsdl.
2. From within the rsdl directory:

ruby ./configure.rb
make
sudo cp rsdl /usr/local/bin/

Installing Rubygame

The simplest way to install Rubygame is: gem install rubygame

Or you can download the source from Github and follow the installation instructions in README.

Running an application

If all went well, you can now run Rubygame applications like so:

rsdl a_rubygame_app.rb

If something bad happened along the way, you can ask for help in the forums. Be sure to include plenty of details and paste any error messages that occur (plus some of the text right before the error messages).