phonegap desktop app - GarthDB/phonegap-day-workshop-beginner GitHub Wiki

PhoneGap Desktop App

http://docs.phonegap.com/getting-started/1-install-phonegap/desktop/

Table of Contents

  1. Overview
  2. Install
  3. Usage
  4. Report an Issue

Overview

The PhoneGap Desktop App is a pre-release of our upcoming OS X and Windows application. It's an excellent alternative to the PhoneGap CLI because it offers a user interface and does not require dependencies such as node.js.

Please keep in mind that this is a pre-release. If you experience issues, we'd greatly appreciate a short and sweet bug report.

Install

1. Download

Download the latest release:

Unfortunately, there is no Linux build although it is possible. If you're up to it, you could clone the project and get it up and running!

2. Install

  1. Double-click the installer.
  2. Follow the directions

Note: OS X users who receive a security error can update their security preferences under System Preference > Security & Privacy > Allow apps downloaded from: Anywhere.

Usage

1. Open the PhoneGap Desktop App

You can now open the application from where you installed it.

2. Open phonegap-app-pgday

  1. Click the + on the right-panel.
  2. Select Add existing PhoneGap project...
  3. Open the project phonegap-app-pgday

3. Start the Server

The server should start by default. You'll know because the bottom of the app has a green banner with your IP address.

If the server has not started, click the arrow (>) to the right of your app's name.

4. Pairing with the PhoneGap Developer App

  • Get your device out.
  • Open the PhoneGap app.
  • Pair your PhoneGap Developer App with the PhoneGap Desktop App.
  • And preview the app! You can type b in the search to filter the people.

5. Get to Work

You can now go back to the edit and reload workflow that we learned about in the PhoneGap Developer App section.

  • Open www/index.html.
  • Edit any content.
  • Save the file.
  • See the updates appear on your device.
  • Grab a beer, feel good about yourself, and make something awesome!

Report an Issue

If you've reached this section of the PhoneGap Desktop App, then you've likely found a bug. We're excited to show you the PhoneGap Desktop App preview and we know there are plenty of issues. This is an opportunity for you to help us improve the app and leave your own personal mark in the open source world!

Please submit a brief issue to hermwong/phonegap-gui/issues. If possible, please provide a brief outline of how to re-create the bug!

Thanks!