Updated License with a Valid SPDX License (#3)

1 file changed
tree: 33bede8afcd61263469033643a859fb59b3b5c76
  1. .github/
  2. AppHarnessUI/
  3. harness-push/
  4. template-overrides/
  5. UrlRemap/
  6. www/
  7. .gitignore
  8. .jshintrc
  9. checkjs.sh
  10. CONTRIBUTING.md
  11. createproject.sh
  12. gulpfile.js
  13. LICENSE
  14. NOTICE
  15. package.json
  16. 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.