Skip to content

phonegap developer app

mwbrooks edited this page Oct 23, 2014 · 15 revisions

PhoneGap Developer App

http://app.phonegap.com/

Overview

The PhoneGap Developer App allows to develop locally and instantly preview your app on your device. This is often called on-device prototyping.

Before the PhoneGap Developer App existed, you had to compile and install your app in order to see your latest changes. This meant you had to install the platforms' SDKs and either use the simulator or setup your signing keys. Thankfully, the PhoneGap Developer App removes this distraction and allows you to start development immediately!

Oh! It's also an entirely open source project available at phonegap/phonegap-app-developer.

Limitations

There are a few limitations to the PhoneGap Developer App.

First, it's purely for development. A production app will need to be properly compiled and signed in order to submit to the app stores.

Second, it does not support Remote Web Inspector debugging, although this is a planned feature.

Third, it is does not support third-party plugins, although this is also on our roadmap.

Install

Works on Android, iOS, and Windows Phone 8.

Head on over to your app store and search for PhoneGap Developer App.

Usage

The PhoneGap Developer App is paired with the PhoneGap CLI to serve a project. When the PhoneGap Developer App is connected to the PhoneGap CLI, you will immediately see your app on the device!

On your computer

  1. Open your terminal to your PhoneGap project.
  2. Serve your project to your device.
$ cd ~/path/to/my-app
$ phonegap serve

On your device

  1. Open the PhoneGap app.
  2. Enter the IP address displayed on your terminal (e.g. 10.0.1.3:3000).

Workflow

The workflow is quite natural. As you change files in my-app/www, your device will instantly update with the latest changes.

Three-finger tap the screen to force an update.

Four-finger tap the screen to navigate back to the home screen.

Try it out

Go ahead and try editing the file my-app/www/index.html!

change:

<h1>PhoneGap</h1>

to:

<h1>Winning!</h1>

After saving, you should immediately see your device update.