summaryrefslogtreecommitdiff
path: root/plugins/cordova-plugin-crosswalk-webview/README.md
diff options
context:
space:
mode:
authorARC <arjunrc@gmail.com>2015-05-13 14:58:25 -0400
committerARC <arjunrc@gmail.com>2015-05-13 14:58:25 -0400
commit73968ba1b3c3b5efeb92f70969e40d143eebf3d8 (patch)
tree25f9d358356645c89c212f014f622d5c831e81d0 /plugins/cordova-plugin-crosswalk-webview/README.md
parent1bef6ad92cafa215e3927d0a4d0a29147d52fe56 (diff)
Added plugin directory as well to make sure you have all you need to compile (hopefully)
Diffstat (limited to 'plugins/cordova-plugin-crosswalk-webview/README.md')
-rw-r--r--plugins/cordova-plugin-crosswalk-webview/README.md83
1 files changed, 83 insertions, 0 deletions
diff --git a/plugins/cordova-plugin-crosswalk-webview/README.md b/plugins/cordova-plugin-crosswalk-webview/README.md
new file mode 100644
index 00000000..c2b25f57
--- /dev/null
+++ b/plugins/cordova-plugin-crosswalk-webview/README.md
@@ -0,0 +1,83 @@
+
+
+Apache Cordova Crosswalk Engine
+===
+
+Cordova Crosswalk Engine is a [Crosswalk WebView](https://crosswalk-project.org/) based engine to work with [Apache Cordova](http://cordova.apache.org/) for Android. This currently works with master branch of [Cordova Android](https://github.com/apache/cordova-android) on GitHub, and it will work with Apache Cordova Android 4.0.0 release.
+
+### Directions:
+#### Android-only:
+* Pull down the Cordova Android
+```
+$ git clone https://github.com/apache/cordova-android.git
+```
+* Generate a project, e.g creating HelloWorld
+```
+$ /path/to/cordova-android/bin/create hello com.example.hello HelloWorld
+```
+* Navigate to the project folder
+```
+$ cd hello
+```
+* Install Crosswalk engine plugin by plugman (version >= 0.22.17)
+```
+$ plugman install --platform android --plugin https://github.com/MobileChromeApps/cordova-crosswalk-engine.git --project .
+```
+* Build
+```
+$ ./cordova/build
+```
+The build script will automatically fetch the Crosswalk WebView libraries from Crosswalk project download site (https://download.01.org/crosswalk/releases/crosswalk/android/) and build for both X86 and ARM architectures.
+
+For example, building HelloWorld generates:
+
+```
+/path/to/hello/build/outputs/apk/hello-x86-debug.apk
+/path/to/hello/build/outputs/apk/hello-armv7-debug.apk
+```
+
+#### Cordova CLI:
+(It will be updated after cordova-android 4.0.0 release with CLI)
+
+* Install the latest version of the Cordova CLI from npm (version >= 4.2.0)
+```
+$ npm install -g cordova
+```
+* Create a project with cordova create, e.g creating HelloWorld
+```
+$ cordova create hello com.example.hello HelloWorld
+```
+* Navigate to the project folder
+```
+$ cd hello
+```
+* Add the Android platform @4.0.0-dev
+```
+$ cordova platform add https://github.com/apache/cordova-android.git
+```
+* Add the Crosswalk engine plugin
+```
+$ cordova plugin add https://github.com/MobileChromeApps/cordova-crosswalk-engine.git
+```
+* Build
+```
+$ cordova build android
+```
+The build script will automatically fetch the Crosswalk WebView libraries from Crosswalk project download site (https://download.01.org/crosswalk/releases/crosswalk/android/) and build for both X86 and ARM architectures.
+
+For example, building android with Crosswalk generates:
+
+```
+/path/to/hello/platforms/android/build/outputs/apk/hello-x86-debug.apk
+/path/to/hello/platforms/android/build/outputs/apk/hello-armv7-debug.apk
+```
+
+Note that it is also possible to publish a multi-APK application on the Play Store that uses Crosswalk for Pre-L devices, and the (updatable) system webview for L+:
+
+To build Crosswalk-enabled apks, add this plugin and run:
+
+ $ cordova build --release
+
+To build System-webview apk, remove this plugin and run:
+
+ $ cordova build --release -- --android-minSdkVersion=21