Instalacion en Mac OS X 10.7 Lion

0. Antes que nada

1. Actualiza Mac OS X con los últimos parches
2. Revisa la página de la terminal si no estás familiarizado con la línea de comandos
3. No olvides revisar las convenciones del wiki
4. Aprende a modificar tu variable PATH

1. Instalar gcc

Para instalar Ruby en tu Mac va a ser necesario compilarlo y para poder hacer eso necesitas gcc. Antes venía incluido en Xcode, pero a partir de la versión 4.2, gcc no es parte del paquete. Por suerte el proyecto OSX GCC Installer tiene unos instaladores independientes.

Para instalarlo por la interfase gráfica debes descargarlo de este enlace. Una vez descargado, das doble click sobre el paquete y sigues las instrucciones hasta instalarlo.

Para descargar e instalarlo desde la terminal sigue estos pasos:

$ cd ~/Desktop
$ curl -L -O https://github.com/downloads/kennethreitz/osx-gcc-installer/GCC-10.7-v2.pkg
# installer -pkg GCC-10.7-v2.pkg -target /

Para comprobar que está instalado puedes ejecutar:

$ gcc -v

2. Instalar Homebrew

En Linux existen herramientas que sirven para instalar software como apt-get, yum o otros dependiendo de la distribucion. En Mac hay varias alternativas, pero una de las más populares recientemente es Homebrew. (¡Además está hecha con Ruby!) Para instalarla debes ejecutar lo siguiente:

$ /usr/bin/ruby -e "$(/usr/bin/curl -fsSL https://raw.github.com/mxcl/homebrew/master/Library/Contributions/install_homebrew.rb)"

O si prefieres puedes seguir estas instrucciones.

Para comprobar que esta instalado, ejecuta:

$ brew -v

Si no está correcto (si ves algún error), revisa que esté correctamente establecida tu variable PATH, deberías incluir /usr/local/bin, así:

export PATH="/usr/local/bin:/usr/local/sbin:$PATH"

3. Instalar git

Git es una herramienta para gestión de versiones que es muy popular entre los usuarios de Ruby. Es importante que la instales porque es un requerimiento para las herramientas siguientes y además es buena práctica gestionar versiones mientras desarrollas software. Para instalarlo debes ejecutar lo siguiente:

$ brew install git

Para comprobar que está instalado ejecuta:

$ git --version

4. Instalar ruby-build

Ruby está siendo constantemente parchado y mejorado, por lo tanto, las versiones van cambiando. Lion viene con Ruby 1.8.7 instalado, pero si quieres usar la versión 1.9.2 o 1.9.3 (por ejemplo), vas a tener que compilarlo. La herramienta ruby-build hace que esto sea más fácil. Para instalar ruby-build solo debes ejecutar:

$ brew install ruby-build

Para comprobar la instalación ejecuta:

$ ruby-build -v

5. Instalar rbenv

Para que sea fácil gestionar las versiones de Ruby que tengas instaladas, puedes usar rbenv. Para instalarlo debes ir a tu home folder y clonar el código:

$ cd
$ git clone git://github.com/sstephenson/rbenv.git .rbenv

Esos comandos van a crear una carpeta oculta llamada .rbenv en tu home folder. Dentro de esa carpeta hay una carpeta para los binarios (ejecutables) que las gemas incluyen, así que se va a tener que incluir en tu variable PATH. O sea que asegúrate que tu archivo .bash_profile tenga definido $PATH de esta manera:

export PATH="$HOME/.rbenv/bin:/usr/local/bin:/usr/local/sbin:$PATH"

Y además incluye esta línea para que tengas opciones adicionales como autocompletar:

eval "$(rbenv init -)"

Después de hacer eso, ejecuta:

$ source .bash_profile

6. Instalar Ruby

Para instalar Ruby, en este caso la versión 1.9.2, debes ejecutar este comando:

$ rbenv install 1.9.2-p290

Y luego ejectuar:

$ rbenv global 1.9.2-p290

Para confirmar que todo está correcto, ejecuta:

$ ruby -v

Debería ver una línea que comienza con ruby 1.9.2p290

Listo, Ruby 1.9.2 está instalado en tu sistema.

7. Cosas a tener en cuenta con rbenv

Cuando instales una gema, sea directamente o vía Bundler (después del bundle install) no te olvides de ejecutar:

$ rbenv rehash

Puedes instalar otras versiones de Ruby también, para saber cuales hay, ejecuta:

$ rbenv install