Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Mirror of Apache Cordova Android

This branch is 8 commits ahead and 378 commits behind master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 framework
Octocat-spinner-32 test
Octocat-spinner-32 .gitignore
Octocat-spinner-32 LICENSE CB-3: Apache source headers in callback-android February 23, 2012
Octocat-spinner-32 NOTICE
Octocat-spinner-32 README.md
Octocat-spinner-32 VERSION
README.md

Cordova Android

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).

Requires

Test Requirements

Building

To create your cordova.jar file, copy the commons codec:

mv commons-codec-1.7.jar framework/libs

then run in the framework directory:

android update project -p . -t android-17
ant jar

Cordova Android Developer Tools

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/bench ............................ generate a bench proj
./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

Running the Example Project

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

Creating a new Cordova Android Project

./bin/create ~/Desktop/myapp com.myapp.special MyApp

Importing a Cordova Android Project into Eclipse

  1. File > New > Project...
  2. Android > Android Project
  3. Create project from existing source (point to the generated app found in tmp/android)
  4. Right click on libs/cordova.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)

Running Tests

Please see details under test/README.md.

Further Reading

Something went wrong with that request. Please try again.