Step 4: Preview Your App
The PhoneGap CLI has a
serve command that starts a small web server to host your project where it can then be consumed by the PhoneGap Developer App running on a mobile device or your desktop browser.
Preview in a Desktop Browser
You can test your apps in your desktop browser first to speed up your initial development process. For instance, if you're using a framework like Angular or React, there are tools available for specifically debugging those frameworks in the browser that can be quite helpful before moving over to a device. Recently PhoneGap began supporting the browser platform as a target automatically to help you test with the
deviceready event and Apache Cordova core plugins more easily in an environment you're already familiar with.
Preview on a Device
You can use the PhoneGap Developer App paired with the PhoneGap CLI to immediately preview your app on a device without installing platform SDKs, registering devices, or compiling code. The PhoneGap CLI starts a small web server to host your project and returns the server address for you to pair with from the PhoneGap Developer App running on your mobile device.
cdinto the project directory created in the previous step and type
$ phonegap serve. You will receive the server address the app is being hosted on in the output received in the console (
192.168.1.11:3000in this example):
$ phonegap serve [phonegap] starting app server... [phonegap] listening on 192.168.1.11:3000 [phonegap] [phonegap] ctrl-c to stop the server [phonegap]
Now go to your mobile device where the PhoneGap Developer App is running, enter the server address on the main screen and tap Connect.NOTE: Tap directly on the server address displayed in the terminal screen of the PhoneGap Developer app to change it to match yours. The value filled in by default is only a sample.
You should see the connection occur followed by a success message as shown below. If you receive an error of any kind, ensure once again that you are connected to the same network on both your device and your computer. You could also check the issue tracker and PhoneGap Google Groups list for further help.
Once the PhoneGap Developer app connects and loads your mobile application, it should be displayed for preview as shown below:TIP: Gestures can be used while you're previewing your app. A 3 finger tap will return you to the main screen, a 4 finger tap will cause a refresh.
Now let's make an update to some code to see how easy it is to test changes. Using your favorite text editor, open up the index.html file located within the www folder of your project; for instance ~/appSample/www/index.html
Choose an update to make. Let's start by changing the PHONEGAP text that's displayed in the app from
<h1>Hello PhoneGap</h1>. (This text has a CSS uppercase transform applied to it in the default project). Save it when you're finished and move on to the next step.
Now check your mobile device where your PhoneGap Developer app is running and you will see your app reload and automatically display the new text!
Continue making updates to your project to get familiar with this workflow.
At this point you should check out this guide explaining important details about the default Hello PhoneGap application and mobile application development tips with PhoneGap in general.