Step 1: Install PhoneGap
The PhoneGap Desktop application provides a drag and drop interface for creating PhoneGap applications. It's an alternative to using the PhoneGap CLI built for those who prefer a visual user interface over a command line interface approach.
NOTE: The getting started steps vary based on the initial PhoneGap tool you install here in step 1. For the rest of the steps be sure to choose either the Desktop or CLI tab at the top accordingly.
Select your operating system to continue:
Mac OS X Installation
- Download the latest Mac OS X Installer.
- Double-click the downloaded file to run the installer. You will initially be prompted with a license agreement to accept:
- Drag and drop the application into the Applications folder on your Mac as prompted:
- Next simply open the application and proceed to Step 2 where you will install the PhoneGap Developer App to your mobile device for previewing the apps you build.
Windows Installation
- Download the latest Windows Installer.
NOTE: If you're unable to run the Windows Installer for some reason, there's also a zip file available that can be used to install PhoneGap Desktop manually. Download the zip file for the latest releaseand follow the instructions in the README and INSTALL files within the downloaded zip.
- Double click the downloaded file to run the installer. You will be prompted with the PhoneGap Desktop Setup Wizard:
- Accept the license agreement:
- Select the desired destination for the application and click Next:
- Select the desired location for the shortcut and click Next:
- Click Install to begin the installation:
- Click Finish to close the Setup Wizard:
- Next simply open the application and proceed to next step below where you will install the PhoneGap Developer App to your mobile device for previewing the apps you build.
Step 2: Install Mobile App
The PhoneGap Developer App is a mobile app that runs on devices and allows you to preview and test the PhoneGap mobile apps you build across platforms without additional platform SDK setup. It automatically provides access to the PhoneGap core APIs providing instant access to the native device features without having to install any plugins or compile anything locally. It's meant to provide an easy way for developers to get started creating and testing their PhoneGap applications quickly with minimal setup.
Install PhoneGap Developer
- Locate the free PhoneGap Developer app from one of the following supported app marketplaces and install it to your mobile device:
- Once installed, tap the PhoneGap Developer app icon from your home screen to open it:
- Once installed, move on to the next step where you will create your first PhoneGap app using the tool you selected in step 1.NOTE: The platform SDKs mentioned above refer to the software development kits Apple, Google and Microsoft provide to build applications for their platforms (iOS, Android and Windows respectively). When you're ready to take your mobile application development further or decide you want to build for each platform locally yourself, you can find the specific instructions for each platform in the PhoneGap Platform Installation Guides.
Step 3: Create Your App
Now that you've installed PhoneGap Desktop and/or the PhoneGap CLI to your computer and the PhoneGap Developer App to your mobile devices, you're ready to create your first PhoneGap project. This project will be a PhoneGap mobile app with the ability to run on multiple devices and across operating systems in just a few simple steps.
Create a PhoneGap Project
- Click the plus sign and select Create new PhoneGap project as shown below:
- You will be prompted with the template list dialog as shown below, where you can choose to create an app based on a sample project.
Each template has a brief description below the name indicating what type of project will be created. To select a template, click on the radio button next to it. In the image below, the Hello World template is selected.
The first template option in the list is the default Hello World project. It's proven to be the quickest and easiest way to understand the basics of building a mobile PhoneGap app so let's start there.
- Ensure the radio button next to the Hello World template is selected.
- Click on the green Next button.
- You will be presented with a screen to enter information about your project. Choose the path on your local hard drive where you want to create the project, a designated name and an optional identifier. Once the information has been entered, click the green Create project button.Be aware that the ID field is also known as the package identifier for Android and the bundle identifier for iOS.
- You should now see a view like below, with your new project shown and marked with a left green border, a green play button next to it and a green bar at the bottom. You should also see a server address indicating it's running and the active project. Only one project will be active and running at any time.TIP: The server address shown for your project at the bottom in the green bar will be used in the next step so make note of it or keep it open.



