github/cordova-android
github/cordova-android
3
0
Fork 1
mirror of https://github.com/apache/cordova-android.git synced 2025-02-22 00:32:55 +08:00
Code Issues Packages Projects Releases Wiki Activity

Expanded instructions in README.

Browse Source
This commit is contained in:
unknown 2010-01-21 00:22:39 -08:00
parent d81f53465f
commit 4144587640
1 changed files with 16 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
README.md
View File

@ -1,33 +1,33 @@
PhoneGap Android PhoneGap Android
============================================================= =============================================================
PhoneGap Android is an Android application library that allows 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.
for PhoneGap based projects to be built for the Android Platform.
Pre-requisites Pre-requisites
------------------------------------------------------------- -------------------------------------------------------------
* Java JDK 1.5 * Java JDK 1.5
* Android SDK Package [http://developer.android.com](http://developer.android.com) * Android SDK Package [http://developer.android.com](http://developer.android.com)
* Apache ANT (For build script) * Apache ANT (For build script)
* Ruby, Rubygems, nokogiri (for build.rb)
Recommended: Recommended:
---------------------------------------------------------------- ----------------------------------------------------------------
* Ruby, Rubygems (for build.rb)
* Eclipse (Recommended for back-end debugging, not required) * Eclipse (Recommended for back-end debugging, not required)
Getting Started from Command Line Getting Started with PhoneGap Android
-------------------------------------- --------------------------------------
Step 1: cd framework && ant jar 1. 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.
Step 2: In the root directory, run: 2. Clone the repository using git, from command line: git clone git://github.com/phonegap/phonegap-android.git
3. Run 'cd phonegap-android/framework'
ruby build.rb <app-name> <package_name> <wwwdir> <path> 4. Make sure you change the location of your Android SDK, this is inside the local.properties file
5. 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).
app-name: Name of application without spaces 6. cd back to the root directory (cd ..)
package name: Java namespace of package ( i.e. com.nitobi.demo) 7. Run 'ruby build.rb <app-name> <package_name> <wwwdir> <path>', where:
www-dir: www directory which includes an icon.png file for the icon - app-name: Name of application without spaces
path: The path you wish to put your PhoneGap Application - 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
8. 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.
Using Eclipse with PhoneGap Using Eclipse with PhoneGap
------------------------------------------------------------- -------------------------------------------------------------
The wiki article to get started with Eclipse can be found at [http://phonegap.pbworks.com/Getting-started-with-Android-PhoneGap-in-Eclipse](http://phonegap.pbworks.com/Getting-started-with-Android-PhoneGap-in-Eclipse) The wiki article to get started with Eclipse can be found at [http://phonegap.pbworks.com/Getting-started-with-Android-PhoneGap-in-Eclipse](http://phonegap.pbworks.com/Getting-started-with-Android-PhoneGap-in-Eclipse)