cordova-android/README.md

PhoneGap/Android
================
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 with web technology: HTML, CSS and JavaScript. 

Pre-requisites
--------------
- Java JDK 1.5
- Android SDK Package [http://developer.android.com](http://developer.android.com)
- Apache ANT
- Ruby

Recommended
-----------
- Eclipse (Great for debugging and extending PhoneGap/Android with your own Java plugins.)

Getting Started with PhoneGap/Android
--------------------------------------

1. From the root of this repo run the following command to generate a new PhoneGap/Android app:

<pre>    
    ./droidgap [android_sdk_path] [target] [name] [package_name] [www] [path]

    android_sdk_path ... The path to your Android SDK install.
    target ......................The target version of the Android platform (3, 4, 6, 7, 8 correspond to 1.5, 1.6, 2.0.1, 2.1, 2.2).
    name ............... The name of your application.
    package_name ....... The name of your package (For example: com.nitobi.demo)
    www ................ The path to your www folder. (Wherein your HTML, CSS and JS app is.)
    path ............... The path to generate the application.
</pre>

Thats it!

Importing a PhoneGap/Android app into Eclipse
---------------------------------------------

1. File > New > Project...
2. Android > Android Project
3. Create project from existing source (point to the generated app). This should import the project into Eclipse. Almost done!
4. Right click on libs/phonegap.jar and add to build path.
5. Right click on the project root: Run as > Run Configurations
6. Click on the Target tab and select Manual (this way you can choose the emulator or device to build to).

For more info see
-----------------
- [http://docs.phonegap.com](http://docs.phonegap.com)
- [http://wiki.phonegap.com](http://wiki.phonegap.com)