PhoneGap Android is an Android application library that allows for PhoneGap-based projects to be built for the Android Platform. PhoneGap-based applications are, at the core, an application written in web-based languages, generally HTML, CSS and JavaScript.
- Java JDK 1.5
- Android SDK Package http://developer.android.com
- Apache ANT (For build script)
- Ruby, Rubygems, nokogiri (for build.rb)
- Eclipse (Recommended for back-end debugging, not required)
- Make sure you have Ruby and the nokogiri gem installed. Run 'gem list' to see a list of installed Ruby gems, and 'gem install nokogiri' from command-line if you don't have it.
- Clone the repository using git, from command line: git clone git://github.com/phonegap/phonegap-android.git
- Run 'cd phonegap-android/framework'
- Make sure you change the location of your Android SDK, this is inside the local.properties file
- Run 'ant jar' - this will create the phonegap.jar file and build a fresh phonegap.js for use in your HTML/JS/CSS-based application (for accessing native functionality).
- cd back to the root directory (cd ..)
- Run 'ruby build.rb <package_name> ', where:
- app-name: Name of application without spaces
- package name: Java namespace of package ( i.e. com.nitobi.demo). This must be unique otherwise it won't load properly on your phone
- www-dir: www directory which includes an icon.png file for the icon
- path: The path to copy the final project assets into, i.e. the final build path
- Now you can use the generated Android code that is located in the 'path' directory from the above step and do what you want with it: import into Eclipse to test with the simulator or otherwise.
The wiki article to get started with Eclipse can be found at http://phonegap.pbworks.com/Getting-started-with-Android-PhoneGap-in-Eclipse