Mirror of Apache Cordova app harness
JavaScript Java Objective-C HTML Shell CSS
Permalink
Failed to load latest commit information.
.github
AppHarnessUI Fix AppHarnessUI.java to work with latest cordova-android changes & t… May 13, 2015
UrlRemap Make UrlRemap not apply to the main webview Oct 25, 2014
harness-push
template-overrides
www/cdvah
.gitignore Add /node_modules to .gitignore Jan 8, 2015
.jshintrc
CONTRIBUTING.md
LICENSE
NOTICE
README.md
checkjs.sh
createproject.sh
gulpfile.js
package.json

README.md

cordova-app-harness

An App that can run Cordova apps within it.

Primary Goals:

  • Super-fast edit & refresh workflow
    • E.g. have a grunt watch that pushes every time a file changes
    • E.g. have livereload-type functionality for CSS & images
  • Test on devices without needing platform SDKs
    • E.g. develop for iOS on a Windows machine
    • Non-goal: Release to iOS from Windows

How to use it:

  1. Run the app on a device or simulator
  2. Push your app to it via the harness-push tool
  3. Use two-finger double-tap to bring up in-app menu.

Building the App Harness

Using a Unix environment, run:

./createproject.sh DirName
cd DirName
cordova plugin add PLUGINS_THAT_YOU_WANT

Major Unimplemented Features

  • Applying app settings (DisallowOverscroll, etc)
  • Applying app splashscreen
  • Applying app's whitelist

Major Unimplemented In-App Menu Features

  • Inject a JSConsole script tag
  • Initiate a weinre session
  • Suggestions welcome! :)

Harness Server

A server runs within the app that enables remote control functionality.

Use harness-push/harness-push.js to send commands to the App Harness.