Introduction

There is a demonstration of the iUI samples and test pages running on Google App Engine at demo.iui-js.org

The instructions below explain how you can use the Google App Engine SDK to run the samples locally. This can be useful for testing form behavior in the sample apps, for example. They also document how to deploy to Google App Engine.

The Music Sample is now an HTML 5 webapp supporting offline operation.

Development with the Google App Engine SDK

Note: These instructions were tested with AppEngine Java SDK 1.6.0 and Gaelyk Version 1.1. You must have Java installed on your system, but there are no longer any other prerequisites.

To install and test (Mac OS X, Linux)

1. Clone the latest iUI source to your system using Git

git clone https://code.google.com/p/iui/ iui-main-repo

2. From the iUI project root type:

cd iui-main-repo
./runWebApp.sh

(the GAE SDK and other Java tools will be automatically downloaded - takes about 15-30 minutes on the first run.)

3. load http://localhost:8080/ in your browser

Windows note

You should be able to type ./gradlew.bat gaeRun from a command console in place of ./runWebApp.sh - this has not been tested. If you try it, please let us know the results.

To deploy:

1. Make sure version and application are set correctly in web-app/WEB-INF/appengine-web.xml
2. run ./gaeDeploy.sh from the iUI project root

To Do List

1. Configure Gaelyk to load .gtpl files from requests with a .php extension (so that static HTML files can reference .php URLs and work with either PHP or Gaelyk)
2. Custom icon for launch WebApp (rather than using list right arrow)
3. Better UI for listing sample apps (springboard like)