Skip to content
This repository has been archived by the owner on Jan 31, 2023. It is now read-only.

Commit

Permalink
Docs updates for PhoneGap Desktop 0.4.0 Release
Browse files Browse the repository at this point in the history
  • Loading branch information
hollyschinsky committed Oct 26, 2016
1 parent a98b2aa commit e628e64
Show file tree
Hide file tree
Showing 8 changed files with 43 additions and 19 deletions.
8 changes: 6 additions & 2 deletions docs/1-getting-started/1-install-phonegap/1-desktop.html.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 25,7 @@ Select your operating system to continue:

## Mac OS X Installation

1. Download the latest [Mac OS X Installer](https://github.com/phonegap/phonegap-app-desktop/releases/download/0.3.5/PhoneGapDesktop.dmg).
1. Download the latest [Mac OS X Installer](https://github.com/phonegap/phonegap-app-desktop/releases/download/0.4.0/PhoneGapDesktop.dmg).

1. Double-click the downloaded file to run the installer. You will initially be prompted with a license agreement to accept:

Expand All @@ -43,7 43,11 @@ Select your operating system to continue:

## Windows Installation

1. Download the latest [Windows Installer](https://github.com/phonegap/phonegap-app-desktop/releases/download/0.3.5/PhoneGapSetup-win32.exe).
1. Download the latest [Windows Installer](https://github.com/phonegap/phonegap-app-desktop/releases/download/0.4.0/PhoneGapSetup-win32.exe).

<div class="alert--info">**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 release](https://github.com/phonegap/phonegap-app-desktop/releases)
and follow the instructions in the README and INSTALL files within the downloaded zip.</div>

1. Double click the downloaded file to run the installer. You will be prompted with the PhoneGap Desktop Setup Wizard:

Expand Down
17 changes: 14 additions & 3 deletions docs/1-getting-started/3-create-your-app/1-desktop.html.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,14 13,25 @@ next: 1-getting-started/4-preview-your-app/1-desktop.html.md
Now that you've installed [PhoneGap Desktop](/getting-started/1-install-phonegap/desktop) and/or the [PhoneGap CLI](/getting-started/1-install-phonegap/cli) to your computer and the [PhoneGap Developer App](/getting-started/2-install-mobile-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 Default PhoneGap Project

The PhoneGap desktop tools include a default Hello World project for beginners to start with. 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:
## Create a PhoneGap Project

1. Click the plus sign and select **Create new PhoneGap project** as shown below:

![](/images/desktop-app-plus.png)

2. 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.

![Templates Dialog](/images/templates-list.png)

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.

1. Ensure the radio button next to the **Hello World** template is selected.

2. Click on the green **Next** button.

1. 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.

![](/images/desktop-app-create-info.png)
Expand Down
2 changes: 1 addition & 1 deletion docs/3-references/desktop-app/1-install/1-mac.html.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 9,7 @@ tabs:
url: references/desktop-app/install/win
---

1. Download the latest [Mac OS X Installer](https://github.com/phonegap/phonegap-app-desktop/releases/download/0.3.5/PhoneGapDesktop.dmg).
1. Download the latest [Mac OS X Installer](https://github.com/phonegap/phonegap-app-desktop/releases/download/0.4.0/PhoneGapDesktop.dmg).

1. Double-click the downloaded file to run the installer. You will initially be prompted with a license agreement to accept:

Expand Down
6 changes: 5 additions & 1 deletion docs/3-references/desktop-app/1-install/2-win.html.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 9,11 @@ tabs:
url: references/desktop-app/install/win
---

1. Download the latest [Windows Installer](https://github.com/phonegap/phonegap-app-desktop/releases/download/0.3.5/PhoneGapSetup-win32.exe).
1. Download the latest [Windows Installer](https://github.com/phonegap/phonegap-app-desktop/releases/download/0.4.0/PhoneGapSetup-win32.exe).

<div class="alert--info">**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 release](https://github.com/phonegap/phonegap-app-desktop/releases)
and follow the instructions in the README and INSTALL files within the downloaded zip.</div>

1. Double click the downloaded file to run the installer. You will be prompted with the PhoneGap Desktop Setup Wizard:

Expand Down
21 changes: 13 additions & 8 deletions docs/3-references/desktop-app/2-create-project.html.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,29 18,34 @@ and drop.

![Create Project Button](/images/docs-add-new.png)

### 2. **Using the File Menu**
### 2. Using the File Menu

Click **File -> New Project** in the menu bar to create a new project. You will be taken directly to the **New Project Dialog**
explained below.

![File New Project](/images/docs-file-menu.png)

### 3. **Using Drag & Drop**
## New Project Dialog

You can also drag any file or folder onto the PhoneGap Desktop interface to trigger the dialog below. Choose **Create new PhoneGap project**.
Once you've chosen to create a new project you will be prompted with the **STEP 1 of 2 | SELECT A TEMPLATE** dialog where you can choose
to create your app based on a template from the list shown. 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.

![Add New Project Dialog](/images/docs-add-new.png)
![Templates Dialog](/images/templates-list.png)

## New Project Dialog
Once you've selected the template you want to use, click on the green **Next** button. You will be taken to
the **STEP 2: PROJECT DETAILS** dialog to enter the details about your app.

Once you've chosen to create a new project you will be prompted with the **New Project Dialog** to enter details about your app.
![Create New Project Dialog](/images/docs-create-dialog.png)

1. Choose a folder where your project will be created in the **Local path** section.
1. Choose a folder where your project will be created in the **Local path** section.
<div class="alert--info"> **NOTE:** This path will default to the last path chosen once you've created your first project.</div>
1. Enter a name for your project in the **Name** section.
1. Optionally enter a project ID in the **ID** text field. If you choose not to enter a project ID, your project will be given a default ID of `com.phonegap.helloworld`. This ID field will be used for the *package identifier* for Android and the *bundle identifier* for iOS and is typically in reverse domain style.
1. Click on the **Create project** button. Your new project will be created and started on the local web server. The project created will be based on the default PhoneGap Hello World application.

![Create New Project Dialog](/images/docs-create-dialog.png)


## Next Steps

Expand Down
8 changes: 4 additions & 4 deletions docs/3-references/desktop-app/3-open-project.html.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,15 23,15 @@ There are multiple ways to open an existing project in PhoneGap Desktop, similar

### 3. Using Drag & Drop

Drag a file or folder anywhere onto the PhoneGap Desktop's interface and it will also trigger the dialog below. Choose
**Add existing PhoneGap project**.
![Add New Project Dialog](/images/docs-open-existing.png)
You can also drag any file or folder onto the PhoneGap Desktop interface to add it to your list of projects. Locate the
project you would like to add from you hard drive and drag it into the Desktop app in the area marked *Drop PhoneGap project folders here*:
![Drag Drop Location](/images/drag-drop-location.png)

### Select Existing Project

After choosing one of the methods above, you will be prompted with a file selection dialog. Choose the root project folder for the existing PhoneGap project you wish to open in PhoneGap Desktop. It will immediately be set as the active project and started on the local web server.

![Add New Project Dialog](/images/opened-existing-project.png)
![Open existing project dialog](/images/opened-existing-project.png)

### Next Steps

Expand Down
Binary file modified public/images/drag-drop-location.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified public/images/templates-list.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit e628e64

Please sign in to comment.