All that you need to get started with the examples is Git and Ruby (1.8 or 1.9). Below you find the basic instructions for an easy installation on Mac, Linux and Windows.
The easiest way for managing packages on Mac OS X is Homebrew
To install it open a terminal and paste the following command:
/usr/bin/ruby -e "$(curl -fsSL https://raw.github.com/gist/323731)"
Once you have installed Homebrew you can install Git with the following command:
brew install git
Ruby 1.8.7 is preinstalled on Mac OS X Lion (Tiger ships with Ruby 1.8.2 and Leopard with 1.8.6). If you want to install the latest version of Ruby or if you want to manage multiple versions, the best option is to install RVM (Ruby Version Manager).
Open the terminal and run the following commands:
bash < <(curl -s https://raw.github.com/wayneeseguin/rvm/master/binscripts/rvm-installer )
rvm install 1.9.2
rvm use 1.9.2 --default
This will install the latest version 1.9.2 and making it as the default Ruby interpreter
For more information you can check this page.
On Debian Linux (like Ubuntu) you can install Git using the apt package manager. Open a terminal and paste the following code:
apt-get install git-core
On Debian Linux (like Ubunutu) you can use the apt package manager to install Ruby:
$ sudo apt-get install ruby1.9.1
Note that this will install version 1.9.2 and not 1.9.1
###Git Installing Git is pretty easy. Just download and insall the package called msysGit.
###Ruby The easiest way to install Ruby on Windows is to use the self-contained installer RubyInstaller. Just run the installer and you are done. If you are planning to use Ruby on Rails, you should consider the RailsInstaller
All the examples are contained in a single Git repository that is hosted on GitHub. Here you can find the instructions how to clone the repository and launch the examples.
The first step is to configure your Git with your GitHub account. If you haven't done it yet, create an account at GitHub
Once you have created the account you can follow these guides for configuring your Git: Mac, Linux and Windows
You can download the examples by simply cloning this GitHub repository. Open a terminal and run the following code:
git clone git@github.com:aaltowebapps/MobileWebAppsExamples.git
This will create a directory called MobileWebAppsExamples
which contains all the examples in separate subdirectories. If you want you can rename it to something else.
If in the future you need to fetch the changes from the server, you can run the following commands in a terminal:
cd MobileWebAppsExamples
git pull
In the directory MobileWebAppsExamples
there is a file called Gemfile
that contains all the additional modules (called gems) that
are required to run the examples.
The first thing is to install Bundler that is tool for managing application's dependencies for Ruby. You can install it by running the following commands in a terminal:
gem install bundler
Once you have install Bundler you can install the additional gems by running the following commands:
cd MobileWebAppsExamples
bundle install
Each subdirectory contains a seprate example. Most of examples are based on Sinatra and you can launch the server with the following command:
ruby server.rb