106 lines
3.0 KiB
Markdown
106 lines
3.0 KiB
Markdown
|
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/)
|