Skip to content
This repository was archived by the owner on Apr 3, 2020. It is now read-only.

crosswalk-project/crosswalk-cordova-android

Folders and files

NameName
Last commit message
Last commit date

Latest commit

a5fc3b8 · Dec 2, 2015
May 11, 2015
May 29, 2015
Jun 24, 2014
Dec 24, 2014
Mar 31, 2015
May 21, 2013
May 30, 2014
Jul 9, 2014
May 6, 2014
Dec 2, 2015
Sep 5, 2014
Sep 12, 2014
Sep 12, 2014

Repository files navigation

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