Awesome
cordova-app-harness
📌 Deprecation Notice
This repository is deprecated and no more work will be done on this by Apache Cordova. You can continue to use this and it should work as-is but any future issues will not be fixed by the Cordova community.
Feel free to fork this repository and improve your fork. Existing forks are listed in Network and Forks.
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
- E.g. have a
- 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:
- Run the app on a device or simulator
- Push your app to it via the harness-push tool
- 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.