Google Git
Sign in
apache / cordova-app-harness / 425a9e2bff0a81349ea58328919d74b81098fc40
commit425a9e2bff0a81349ea58328919d74b81098fc40[log] [tgz]
authorAndrew Grieve <agrieve@chromium.org>Thu May 29 13:49:19 2014 -0400
committerAndrew Grieve <agrieve@chromium.org>Thu May 29 13:49:19 2014 -0400
tree500993c78b44aacdc5c46a45cb4bd82f11007ae9
parentdaff4a57594253357822c21adfd46aa2d201b68b [diff]
Don't use UrlRemap on iOS (buggy with multiple webviews)
2 files changed
tree: 500993c78b44aacdc5c46a45cb4bd82f11007ae9
  1. AppHarnessUI/
  2. CacheClear/
  3. harness-push/
  4. UrlRemap/
  5. www/
  6. .gitignore
  7. .jshintrc
  8. .reviewboardrc
  9. checkjs.sh
  10. config.xml
  11. CONTRIBUTING.md
  12. createproject.sh
  13. LICENSE
  14. NOTICE
  15. README.md
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.