Skip to content

Building Green Shoes on Ubuntu

Zachary Scott edited this page Nov 2, 2010 · 5 revisions

Building Green Shoes on Ubuntu

In order to develop green_shoes on Ubuntu you're going to have to pass these initial requirements:

Once you have the above installed you're ready to install the development dependencies

Build Dependencies

cairo

Many distributions including Debian, regularly include recent versions of cairo. As more and more applications depend on cairo, you might find that the library is already installed. To get the header files installed as well may require asking for a -dev or -devel package as follows:

For Debian and Debian derivatives including Ubuntu:

sudo apt-get install libcairo2-dev

For more information regarding this, please see the official documentation.

gtk

For the gtk environment you'll need to install some binary packages on your platform.

sudo apt-get install libgtk2.0-dev

Once you have these header packages installed you can build the ruby bindings for each of these.

Ruby Bindings

The ruby bindings allow us to use pango and cairo in pure ruby.

rcairo

You have a couple options when installing the rcairo bindings.

Rubygems

gem install cairo -v=1.10.0

We use rcairo version 1.10.0 for green_shoes development. For more information see the official documentation.

ruby-gtk2

The ruby-gtk2 project is a meta package of the common gtk2 development bindings.

Rubygems

gem install gtk2 -v=0.90.5

Green Shoes uses the gtk2 meta gem of at least 0.90.5 or greater.

Install the green_shoes gem

If you've made it this far you should be able to install the green_shoes gem. Although the green_shoes gem will require the gtk and cairo ruby bindings installed on your system, it's good to install them one at a time your first run through. It will help you in the event you get stuck during the build process to know exactly which requirement you're missing.

gem install green_shoes

This is the easiest way for you to get started using building green_shoes applications on Linux.

The green_shoes source is available on github for development.