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 0 commits ahead and 491 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, an application written with web technology: HTML, CSS and JavaScript.

Apache Cordova is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator project. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

Requires

Test Requirements

Building

To create your cordova.jar, 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.