Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 

cordova-plugin-gapreload

LiveReload plugin for Cordova/PhoneGap applications. Watch the video demo (installation procedure a bit outdated, see below instead).

Installation

Note: if you use the grunt-gapreload task, skip these steps and follow the proper documentation instead.

  1. Install the LiveReload app (latest version can be found here).
  2. Install the Apache Cordova 3 CLI: $ npm install -g cordova (you may need to use sudo).
  3. cd into your Cordova app folder previously created using the cordova create command.
  4. Install GapReload: $ cordova plugin add pro.fing.cordova.gapreload --variable SERVER_HOST="<host>" where <host> typically is your localhost IP address (static is better). Note that passing the SERVER_HOST is now optional since the plugin will also prompt you to set it at runtime.
  5. Follow GapReload instructions in your terminal window and you will be good to go.

Configuration

The SERVER_HOST variable is somehow mandatory. Other available variables are:

Variable name Default value
SERVER_PORT 8000
LIVERELOAD_HOST SERVER_HOST
LIVERELOAD_PORT 35729

Generally you should not modify those values but, if you really have to, just know that you can.

Setting values for SERVER_HOST and LIVRELOAD_HOST using the CLI will also automagically whitelist them for you.

But you can also declare/override values in plugins/pro.fing.cordova.gapreload/gapreload.xml like so:

<?xml version="1.0" encoding="UTF-8"?>
<gapreload>
  <param name="SERVER_HOST" value="whatever you want"/>
  <param name="SERVER_PORT" value="whatever you want"/>
  <param name="LIVERELOAD_HOST" value="whatever you want"/>
  <param name="LIVERELOAD_PORT" value="whatever you want"/>
</gapreload>

Removal

Note: if you use the grunt-gapreload task, skip these steps and follow the proper documentation instead.

Because you shouldn't let this plugin make it to production.

  1. cd into your Cordova app folder.
  2. Execute $ cordova plugin remove pro.fing.cordova.gapreload.
  3. That's it, GapReload is gone for good.

Notes

  • As GapReload will redirect your whole app to http://$SERVER_HOST:$SERVER_PORT/, cross-origin requests won't work anymore without a proper configuration.

TODO

  • Test on platforms other than iOS and Android and make it work if needed.

Weird stuff to investigate

  • I noticed that when using Chrome 32.0.1700.107 and LiveReload 2.3.34, once every two page refresh, the livereload.js file doesn't load at all. An error is thrown and this is what I get for this particular request in the developer tools: caution provisional headers are shown...

About

LiveReload plugin for Cordova/PhoneGap applications.

Resources

License

Stars

Watchers

Forks

Packages

No packages published