Cordova Android is an Android application library that allows for Cordova-based projects to be built for the Android Platform. Cordova based applications are, at the core, applications written with web technology: HTML, CSS and JavaScript.
Apache Cordova is a project at The Apache Software Foundation (ASF).
- Java JDK 1.5 or greater
- Apache ANT 1.8.0 or greater
- Android SDK https://developer.android.com
The Cordova developer tooling is split between general tooling and project level tooling.
To enable the command-line tools available in the ./bin directory, make
sure you have all of the dependencies installed. You will need
NodeJS (which should come with npm
). To install
the dependencies:
$ cd bin
$ npm install
General Commands
./bin/create [path package activity] ... create the ./example app or a cordova android project
./bin/autotest ......................... test the cli tools
./bin/test ............................. run mobile-spec
Project Commands
These commands live in a generated Cordova Android project.
./cordova/debug [path] ..................... install to first device
./cordova/emulate .......................... start avd (emulator) named default
./cordova/log .............................. starts logcat
Start avd (emulator) named default
:
./bin/emulate
Create the example project and build it to the first device:
./bin/create
cd example
./cordova/debug
Start adb logcat (console.log calls output here):
./cordova/log
./bin/create ~/Desktop/myapp com.myapp.special MyApp
- File > New > Project...
- Android > Android Project
- Create project from existing source (point to the generated app found in tmp/android)
- Right click on libs/cordova.jar and add to build path
- Right click on the project root: Run as > Run Configurations
- Click on the Target tab and select Manual (this way you can choose the emulator or device to build to)
Note: The Developer Tools handle this. This is only to be done if the tooling fails, or if you are developing directly against the framework.
To create your cordova.jar
file, run in the framework directory:
android update project -p . -t android-17
ant jar
Please see details under test/README.md.