mirror of https://github.com/apache/cordova-android.git synced 2025-01-31 17:32:51 +08:00

Go to file

HUANG Menghuai 778b784eb6 [CB-2908] Fix the DroidGap activity Lifecycle broken issue Attempting to invoke the Activity's finish() onDestroy breaks an Activity's lifecycle flag. OnDestroy can be called by the system, for instance, on restarting an Activity, it's definitely different from a normal finish(). Finish() incorrectly in onDestroy results in another DroidGap derived activity is started, while the original one is not yet onDestroy. This issue could be found when the system is trying to restart the activity upon, for instance, receiving immediately successive device Config changes.		2013-04-04 16:47:03 -04:00
bin	Prep for 2.6.0 final	2013-04-01 14:54:51 -07:00
framework	[CB-2908] Fix the DroidGap activity Lifecycle broken issue	2013-04-04 16:47:03 -04:00
test	Updated XML for the test project	2013-02-18 11:26:40 -08:00
.gitignore	ignore IntelliJ files	2013-03-01 21:56:57 -08:00
LICENSE	CB-3: Apache source headers in callback-android	2012-02-23 11:36:08 -05:00
NOTICE	updated NOTICE file	2012-06-06 11:55:11 -07:00
README.md	minor readme stuff	2013-02-15 13:18:03 -08:00
VERSION	Prep for 2.6.0 final	2013-04-01 14:54:51 -07:00

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

Java JDK 1.5 or greater
Apache ANT 1.8.0 or greater
Android SDK http://developer.android.com
Apache Commons Codec http://commons.apache.org/codec/

Test Requirements

JUnit - https://github.com/KentBeck/junit

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

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)

Running Tests

Please see details under test/README.md.