Getting Started

Emulate PhoneGap

• http://phonegap.com
• http://localhost:3000

Emulate a Specific Platform

• http://phonegap.com?platform=cordova
• http://phonegap.com?platform=phonegap

Emulate a Specific Platform Version

• http://phonegap.com?platform=cordova-2.0.0
• http://phonegap.com?platform=phonegap-1.0.0

About

PhoneGap Emulator

• The PhoneGap Emulator allows you to test your PhoneGap application from your desktop browser. PhoneGap's JavaScript APIs are avaialble using Ripple, so you can subscribe to deviceready and even stub responses for your custom plugins.

Requirements

• The PhoneGap Emulator requires two free, third-party tools.
• 1. Google Chrome Browser by Google.
• 2. Ripple Emulation Environment by the BlackBerry HTML Team.

API

Overview

The PhoneGap emulator can be invoked with a web request. The request options are provided as query string parameters and the response will check for all dependencies before opening the Ripple emulator.

Request

• http://emulate.phonegap.com?url=<url>&platform=<platform>

Parameters

URL

• The url is the address of your local or public web app.
• The url is a required parameter.

• Examples:

• http://emulate.phonegap.com?url=phonegap.com
• http://emulate.phonegap.com?url=http://phonegap.com
• http://emulate.phonegap.com?url=http://phonegap.com/images

Platform

• The platform is the environment to emulate.
• The platform is an optional parameter.

• Emulates latest version:

• http://emulate.phonegap.com?url=phonegap.com&platform=cordova
• http://emulate.phonegap.com?url=phonegap.com&platform=phonegap

• Emulates specific version:

• http://emulate.phonegap.com?url=phonegap.com&platform=cordova-2.0.0
• http://emulate.phonegap.com?url=phonegap.com&platform=phonegap-1.0.0