2013-05-29 04:43:38 +08:00
<!--
#
# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements. See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership. The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License. You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied. See the License for the
# specific language governing permissions and limitations
# under the License.
#
-->
2012-01-06 04:33:26 +08:00
Cordova Android
2011-08-19 09:21:51 +08:00
===
2013-01-24 04:17:42 +08:00
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.
2012-01-06 04:33:26 +08:00
2013-02-16 05:12:19 +08:00
[Apache Cordova ](http://cordova.io ) is a project at The Apache Software Foundation (ASF).
2009-11-25 07:11:32 +08:00
2013-01-24 10:31:30 +08:00
2011-08-20 13:20:53 +08:00
Requires
2011-08-19 09:21:51 +08:00
---
2012-09-26 01:09:40 +08:00
- Java JDK 1.5 or greater
- Apache ANT 1.8.0 or greater
2011-08-20 13:20:53 +08:00
- Android SDK [http://developer.android.com ](http://developer.android.com )
2012-01-18 05:31:08 +08:00
2012-05-08 07:30:24 +08:00
2012-01-06 04:33:26 +08:00
Cordova Android Developer Tools
2011-08-19 09:21:51 +08:00
---
2010-01-27 09:58:27 +08:00
2012-01-06 04:33:26 +08:00
The Cordova developer tooling is split between general tooling and project level tooling.
2011-09-02 05:44:02 +08:00
2011-11-01 10:14:05 +08:00
General Commands
2010-08-31 07:02:47 +08:00
2012-01-06 04:33:26 +08:00
./bin/create [path package activity] ... create the ./example app or a cordova android project
2013-07-16 02:27:05 +08:00
./bin/check_reqs ....................... checks that your environment is set up for cordova-android development
./bin/update [path] .................... updates an existing cordova-android project to the version of the framework
2011-09-02 05:44:02 +08:00
Project Commands
2013-07-16 02:27:05 +08:00
These commands live in a generated Cordova Android project. Any interactions with the emulator require you to have an AVD defined.
2011-08-19 13:40:09 +08:00
2013-07-16 02:27:05 +08:00
./cordova/clean ........................ cleans the project
./cordova/build ........................ calls `clean` then compiles the project
./cordova/log ........................ stream device or emulate logs to stdout
./cordova/run ........................ calls `build` then deploys to a connected Android device. If no Android device is detected, will launch an emulator and deploy to it.
./cordova/version ...................... returns the cordova-android version of the current project
2011-08-19 13:40:09 +08:00
2012-01-06 04:33:26 +08:00
Importing a Cordova Android Project into Eclipse
2011-08-20 13:20:53 +08:00
----
2010-01-28 07:11:25 +08:00
1. File > New > Project...
2. Android > Android Project
2010-08-31 07:02:47 +08:00
3. Create project from existing source (point to the generated app found in tmp/android)
2012-02-02 09:45:49 +08:00
4. Right click on libs/cordova.jar and add to build path
2010-01-28 07:11:25 +08:00
5. Right click on the project root: Run as > Run Configurations
2010-08-31 07:02:47 +08:00
6. Click on the Target tab and select Manual (this way you can choose the emulator or device to build to)
2013-05-22 06:23:36 +08:00
Building without the Tooling
---
Note: The Developer Tools handle this. This is only to be done if the tooling fails, or if
you are developing directly against the framework.
2013-05-23 22:23:25 +08:00
To create your `cordova.jar` file, run in the framework directory:
2013-05-22 06:23:36 +08:00
android update project -p . -t android-17
ant jar
2012-05-17 07:13:46 +08:00
Running Tests
----
2012-06-01 07:01:20 +08:00
Please see details under test/README.md.
2010-08-31 07:02:47 +08:00
2011-08-20 13:20:53 +08:00
Further Reading
2010-08-31 07:02:47 +08:00
---
2011-08-20 13:20:53 +08:00
- [http://developer.android.com ](http://developer.android.com )
2013-05-22 06:23:36 +08:00
- [http://cordova.apache.org/ ](http://cordova.apache.org )
2012-09-04 02:10:00 +08:00
- [http://wiki.apache.org/cordova/ ](http://wiki.apache.org/cordova/ )
