uMobile PhoneGap App Setup

Setting up a uMobile PhoneGap Project

General instructions

1. Identify the directions for your platform at http://phonegap.com/start.  You should generally follow the instructions provided there for setting up a PhoneGap project with the exception of replacing the provided or auto-generated www library with that provided by uMobile.
2. Replace the www library with the www folder in the uMobile PhoneGap project at https://github.com/Jasig/umobile-app-phonegap.
3. Copy www/lib/external/cordova-platform-version.js to www/lib/external/cordova.js, where platform and version correspond to the platform on which you're developing and the current version of Cordova.
4. Configure www/config.js to match your portal server.  Note that "localhost" on the Android is reached via the IP address 10.0.2.2.
5. Build as described in the PhoneGap documentation.

iOS Notes

You will need to edit cordova.plist as follows:

1. Set "OpenAllWhitelistURLsInWebView" to true.
2. Add the hostname of the uMobile application server, any authentication servers, and any other servers which host external modules, images, or other resources to the "External Hosts" list.

Android Notes

On Android, "localhost" is reached via the IP address 10.0.2.2.  If you leave the app configured with "localhost" URLs, it won't be able to connect.

BlackBerry Notes

TBD

Windows Notes

TBD

Tools and Tips

• This is a pretty handy Chrome extension to clean out your local storage and private data when you are working in the HTML5 development environment. 
• To debug PhoneGap applications, you may also use this tool provided by PhoneGap. 
• This is a decompiler for Java that is able to reverse engineer DEX libraries produced by the Android VM.
• Slime Editor is a powerful text editor useful in developing front-end applications and Javascript coding.