Setting up a development environment

Setting up an environment

First of all, you're going to need git. You can get it here.

Blue Shoes works with Ruby 1.9.2. I'm using rvm, so to get 1.9.2, just rvm install 1.9.2, and wait!

If you don't have rvm, you can get it here. If you don't want to use rvm... you should.

Grab the source, luke

First, make a fork here on GitHub! Just click the fork button.

Next, clone your version:

$ git clone [email protected]:$YOUR_GITHUB_NAME/blue_shoes.git

This'll make a blue_shoes directory, with all the code inside.

Then, grab git-flow: http://github.com/nvie/gitflow

cd into the blue_shoes directory, and type: 'git flow init'. Give the default for all of the answers, except for when it asks you about devel. Use development instead.

Dependencies

To get qtbindings, first you need qt4 for your platform. Instructions shamelessly stolen from here:

Debian Linux

1. The following should get you the packages you need:

   sudo apt-get install build-essential bison autoconf g++ zlib1g-dev libreadline-dev libsqlite3-dev libxslt-dev libxml2-dev libssl-dev libsqlite3-dev curl git-core subversion xorg-dev libgl1-mesa-dev libglu1-mesa-dev

Mac OSX Snow Leopard

1. XCode
2. qt4-mac installed from macports - NOTE: For some reason smokegen does not work with the SDK or Cocoa libraries directly from qt.nokia.com - Uninstall these if necessary using: sudo python /Developer/Tools/uninstall_qt.py

Windows - Note: Only necessary for debugging (binary gem available)

1. mingw from the Qt SDK in your path: ie C:\Qt\2010.04\mingw\bin

Install the gem

Then you just gem install qtbindings, and off you go!

Use Bundler

Bundler is gaining a lot of steam as a dependency management tool. So we're using it. To build your bundle, just type

$ bundle install

and everything should get built.