THIS REPOSITORY IS DEPRECATED
This repository is based on Cordova-Android 3.6.3, which is not being maintained upstream anymore. It thus does not receive new features or security fixes.
Starting with Cordova-Android 4.0.0, Crosswalk is officially supported with the standard releases and this repository is not necessary anymore.
You are encouraged to follow our Cordova 4+ guide and use a supported Cordova-Android release.
Crosswalk-based Cordova Android
Crosswalk-based Cordova Android is derived from Cordova Android and uses Crosswalk as the HTML5 runtime. It 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 of 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
- Python 2.6 or greater
Setup Crosswalk Dependency
- Please download the crosswalk-webview for Android package from Crosswalk download site.
- Unzip the crosswalk-webview package to a folder and create a link named
xwalk_core_library
underframework
linking to that folder.
For example, on Linux:
$cd /path/to/crosswalk-cordova-android/framework
$ln -s /path/to/crosswalk-webview-unzipped-folder/ xwalk_core_library
Cordova Android Developer Tools
The Cordova developer tooling is split between general tooling and project level tooling.
General Commands
./bin/create [path package activity] ... creates the ./example app or a cordova android project
./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
Project Commands
These commands live in a generated Cordova Android project. Any interactions with the emulator require you to have an AVD defined.
./cordova/clean ........................ cleans the project
./cordova/build ........................ calls `clean` then compiles the project
./cordova/log ........................ streams device or emulator 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
Importing a Crosswalk-based Cordova Android Project into Eclipse
- Import Crosswalk-based Cordova Android and XWalkCoreLibrary library projects by File > Import... > Existing Android Code Into Workspace. Point to
[path_to_cordova_xwalk_android]/framework
and clickFinish
. - Build
xwalk_core_library
andCordova
projects. - Import generated project by File > Import... > Existing Android Code. Point to the generated app 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.