forked from github/cordova-android
106 lines
2.9 KiB
Markdown
Executable File
106 lines
2.9 KiB
Markdown
Executable File
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](http://cordova.io) 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](http://developer.android.com)
|
|
- Apache Commons Codec [http://commons.apache.org/codec/](http://commons.apache.org/codec/)
|
|
|
|
Test Requirements
|
|
---
|
|
- JUnit - [https://github.com/KentBeck/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](http://nodejs.org) (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
|
|
---
|
|
|
|
- [http://developer.android.com](http://developer.android.com)
|
|
- [http://incubator.apache.org/cordova/](http://incubator.apache.org/cordova/)
|
|
- [http://wiki.apache.org/cordova/](http://wiki.apache.org/cordova/)
|