Path: | doc/macosx_install.rdoc |
Last Update: | Thu Jul 01 08:07:51 +0000 2010 |
Note: You can view the latest version of this guide online at the Rubygame wiki: rubygame.org/wiki/Mac_Installation_Guide
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.
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.
sudo apt-get install sdl
sudo apt-get install sdl-gfx13 sdl-image sdl-mixer sdl-ttf
Thanks to Matt Crinklaw for these instructions.
sudo port install libsdl
sudo port install libsdl_gfx libsdl_image libsdl_mixer libsdl_ttf
Thanks to Raffael Mancini (sepisultrum) for these instructions.
In order to use Rubygame applications on Mac OS X, you must use a special wrapper for the Ruby interpreter, called rsdl.
ruby ./configure.rb make sudo cp rsdl /usr/local/bin/
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.
If all went well, you can now run Rubygame applications like so:
rsdl a_rubygame_app.rb
If you have any trouble installing Rubygame, please post in the forums.