Adam Horner asks me:

Can you write a post on how to build the app from the resources you have put on github please?

The application was built with PhoneGap, a framework that allows the development of mobile apps using HTML5, CSS3 and Javascript.

Depending on the platform on which you want to compile the project, you have to create the correct 'container' that will encapsulate the HTML5 source and connect the webapp with smartphone's native functions.


On PhoneGap site is explained the procedure to create a skeleton application, the steps are as follows:

On iOS
  1. Download the latest version of PhoneGap from http://phonegap.com/download
  2. Unzip the archive
  3. Open a shell window and change to the directory "lib/ios/bin" inside the archive unpacked in step 2
  4. From here start the command 'create' to create the skeleton of the project we will use to encapsulate the html source downloaded from GitHub:

    ./create [OUTPUT DIRECTORY] [PACKAGE NAME] [PROJECT NAME]

    for YATTRSSC, the command is:

    ./create ~/Desktop/YATTRSSC_IOS org.andreafortuna.yattrssc YATTRSSC

    Now on the desktop there is a new directory (YATTRSSC_IOS) containing the XCode project.
  5. Open the created project with XCode, delete the contents of the directory 'www' except for the file cordova-xxxjs, which will be renamed as cordova.js
  6. Copy into 'www' folder the source downloaded from the GitHub repository
  7. Apply the patches reported in the file README
  8. Compile the project.
  1. Download the latest version of PhoneGap fromhttp://phonegap.com/download
  2. Unzip the archive
  3. Open a shell window and change to the directory "lib/android/bin" inside the archive unpacked in step 2
  4. Make sure the path is correctly configured
  5. Start the command 'create' to create the skeleton of the project that will be used to encapsulate the html source downloaded from GitHub:

    ./create [OUTPUT DIRECTORY] [PACKAGE NAME] [PROJECT NAME]

    for YATTRSSC, the command is:

    ./create ~/Desktop/YATTRSSC_ANDROID org.andreafortuna.yattrssc YATTRSSC

  6. Open the newly created project with Eclipse, delete the contents of the directory 'assets/www' except for the file cordova-xxxjs, which will be renamed cordova.js
  7. Copy into 'www' folder the source downloaded from the GitHub repository
  8. Apply the patches reported in the file README
  9. Compile the project.