The intended audience for the PhoneGap Developer app is typically beginner-level and just getting started with PhoneGap. For more complete control over your debugging environment you should plan to use the full featured PhoneGap CLI. Since the PhoneGap Developer app is a production version app downloaded from the app stores, you can't use the traditional Remote Debugging tools like Safari and Chrome to debug apps running within it. However, you do currently have two other options for debugging; using the weinre tool or building a custom version of the PhoneGap Developer app.
Weinre is a limited implementation of Remote Web Inspector for remotely debugging apps running on a device.
You can run weinre on your local machine and use it to debug your application being served from either the PhoneGap Desktop App or the PhoneGap CLI.
- Install weinre using npm (requires Node.js)
$ sudo npm install -g weinre
You could also download or clone the project from [the GitHub repo](https://github.com/apache/cordova-weinre).
- Start up weinre with the following command, replacing the IP address with your local machine's IP address found in your network settings:
$ weinre --boundHost x.x.x.x
$ ./weinre --boundHost 192.168.1.20 2015-08-17T20:51:35.866Z weinre: starting server at http://192.168.1.20:8080
- Open your PhoneGap project to debug and add the following script tag in the www/index.html of the project you're debugging, replacing the IP address with yours and including the port 8080.
This will allow weinre access to debug your app when it's being served.
Now use the PhoneGap Desktop Application or PhoneGap CLI to serve it.
Open the PhoneGap Developer app on your mobile device and connect to the IP address the app was served on to complete the pairing process (ie:
Open the browser on your computer and enter the URL weinre was started on (ie:
http://192.168.1.20:8080/in this example):
You should see a view like the following:
Click on the link next to debug client user interface: and you will see the following type of view where the debug target link is shown in blue:
Click on the link in the Targets section and it will turn green when it's connected and you can begin debugging:
Creating Custom Builds
The other option for debugging is to create your own custom build of the PhoneGap Developer App (as opposed to the app marketplace version). This option can be used for debugging using other Remote Debugging tools found in Safari, Chrome and others developers may be more comfortable with. You could also include any other plugins or change settings overall to fit your testing needs. See the guide for more details.