Mac Installation Guide

From Rubygame

Jump to: navigation, search
(Copied and updated the installation guide from Rubygame docs.)
Line 1: Line 1:
 +
== Installing the development environment ==
 +
For those who need to setup a development environment from stratch. You will need adminstrator access to do this.
For those who need to setup a development environment from stratch. You will need adminstrator access to do this.
-
1.Download and install xcode, for your proper version of Mac. You will need a developer account for this.
+
# Download and install xcode, for your proper version of Mac. You will need a developer account for this.
-
*For those who are on 10.5, you can get the latest and greatest [https://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20414 xcode] as of 2009-06-22
+
#* For those who are on 10.5, you can get the latest and greatest [https://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=20414 xcode] as of 2009-06-22
-
*For people who are on 10.4, you are limited to this [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=19907 version.]
+
#* For people who are on 10.4, you are limited to this [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=19907 version.]
-
*For those who are on 10.3, it get even more depressing. You'll get [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=19907 this].
+
#* For those who are on 10.3, it get even more depressing. You'll get [http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=19907 this].
 +
 
 +
== 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 [http://www.finkproject.org/ Fink] ===
 +
 
 +
# [http://www.finkproject.org/download/index.php?phpLang=en Install Fink] and update to the latest version.
 +
# Open a new terminal (can be found in /Applications/Utilities).
 +
# Install SDL: {{code|sudo apt-get install sdl}}
 +
# (Optional, but ''highly'' recommended:) Install the SDL companion libraries: {{code|sudo apt-get install sdl-gfx13 sdl-image sdl-mixer sdl-ttf}}
 +
 
 +
Thanks to Matt Crinklaw for these instructions.
 +
 
 +
=== ...with [http://darwinports.com/ Darwinports] ===
 +
 
 +
# [http://darwinports.com/download/ Install Darwinports] (you must register first).
 +
# Open a new terminal (can be found in /Applications/Utilities).
 +
# Install SDL: {{code|sudo port install libsdl}}
 +
# (Optional, but ''highly'' recommended:) Install the SDL companion libraries: {{code|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.
 +
 
 +
# [http://github.com/knu/rsdl Get rsdl].
 +
# From within the rsdl directory:
 +
 
 +
ruby ./configure.rb
 +
make
 +
sudo cp rsdl /usr/local/bin/
 +
 
 +
== Installing Rubygame ==
 +
 
 +
The simplest way to install Rubygame is: {{code|gem install rubygame}}
 +
 
 +
Or you can [http://github.com/jacius/rubygame/ 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).

Revision as of 04:37, 24 October 2009

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox