/crosswalk-cordova-android

DEPRECATED - Crosswalk-based Cordova Android

Primary LanguageJavaApache License 2.0Apache-2.0

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

Setup Crosswalk Dependency

  1. Please download the crosswalk-webview for Android package from Crosswalk download site.
  2. Unzip the crosswalk-webview package to a folder and create a link named xwalk_core_library under framework 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

  1. 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 click Finish.
  2. Build xwalk_core_library and Cordova projects.
  3. Import generated project by File > Import... > Existing Android Code. Point to the generated app path.
  4. Right click on the project root: Run as > Run Configurations
  5. 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