About PhoneGap Build and Dreamweaver
PhoneGap Build is a cloud-based service that lets you package your web applications as native mobile applications. Integration with Dreamweaver allows you to build and save your apps in a Dreamweaver site, and then upload them to the PhoneGap Build service in the cloud for packaging.
PhoneGap Build supports native application packaging for the following mobile device operating systems:
- Windows 8
For more information on the PhoneGap Build service, see the PhoneGap website.
For help using the PhoneGap Build service, see the PhoneGap Build documentation.
Create a PhoneGap Build service account
You cannot use PhoneGap Build and Dreamweaver without a PhoneGap Build service account. Accounts are free and easy to set up. To create one visit the PhoneGap Build website.
You'll need to validate the account through a confirmation email before the account becomes active.
Set up the development environment
Depending on what kinds of applications you want to package and which devices you want to test on, there are various setup tasks you need to complete before packaging your application. You may want to set up some, all, or none of the following options:
Android SDK If you want to test Android applications on your local computer using an Android emulator, you'll need to download and install the Android SDK. For instructions, see the Android documentation.
Once you've installed the Android SDK, you'll need to start the Android SDK and AVD Managers, and select the Android tools you want to work with locally on your computer. Dreamweaver uses the information you select during this initial setup to populate the Android emulator settings in the PhoneGap Build Service panel. For more information on specifying these settings, see the Android documentation.
IMPORTANT: If you want to use an Android emulator to test your application locally, you should get the emulator working the way you want it to work independently of Dreamweaver before you do your testing.
webOS SDK/PDK If you want to test webOS applications on your local computer using a webOS emulator, you'll need to download and install the webOS SDK/PDK. For instructions, see the webOS documentation.
QR (Quick Response) code readers If you want to easily transfer your packaged app to your device, you'll need a QR code reader. (When you package an application using Dreamweaver, you'll receive a QR code for the app, which will appear in the PhoneGap Build panel, once the app has been packaged.) A number of different code readers are available for free from various marketplaces. For more information, google "QR code reader".
Install the PhoneGap Build add-on
Before using the PhoneGap Build service from within Dreamweaver, you must install the PhoneGap Build add-on.
To install the add-on, go to Window > Browse Add-Ons. The Adobe Creative Cloud Add-Ons page appears. Search for the PhoneGap Build add-on and follow the on-screen instructions to install the add-on.
Important: Before installing add-ons, ensure that you have enabled file sync for your Adobe Creative Cloud account. See Enable file sync on Adobe Creative Cloud for more details.
Package mobile applications with PhoneGap Build
For the operating systems that you are targeting, enter the Key and password as required. Signing key information is required only for Android, iOS, and Blackberry.
If you are unable to build more than one application, it could be because you are not subscribed to the PhoneGap service.
If you enter incorrect information, the build fails with an error message indicating that you entered an incorrect Key or password. If you do not enter any information, iOS build fails with Signing key required error. Android and Blackberry apps are built using the debug certificates.
Notice that Dreamweaver adds a ProjectSettings file to the root of your site. (You might need to refresh the Files panel to see it.) This file is very important, as the PhoneGap Build service uses it to track your application.
Dreamweaver also adds a config.xml file to your site root. Double-click this simple XML file to open it.
Customize the identity of your application by editing the contents of this file. If you don't, all of your applications will have the same default application name.
For more information on working with the config.xml file, see the PhoneGap Build documentation.
Save the edited config.xml file, close it, and click Rebuild in the PhoneGap Service panel. As PhoneGap finishes packaging your application for each platform, you'll see messages indicating that the build is complete.
To package a build for Windows 8, you need to directly log in to https://build.phonegap.com, upload the required files, and compile the build.
By default, Dreamweaver uses PhoneGap Build version 2.9.0. If you want to use the latest version of PhoneGap Build, perform the following steps:
- Remove the following line from the config.xml file at the site root folder:
- Save the file.
- Rebuild the project.
<preference name="phonegap-version" value="2.9.0" />
To download an application from PhoneGap Build, click the Download Application button (downward-facing arrow) in the PhoneGap Build Service panel.
Note: Download is not available for iOS applications without a signing key. For more information, see the PhoneGap Build documentation.
The names of the downloaded application files are as follows:
- iOS - app.ipa
- Android - app.apk
- BlackBerry - app.jad
- webOS - app.ipk
- Symbian- app.wgz
You need to have a QR code reader on your device before proceeding. For more information, see Set up the Development Environment.
Note: QR codes are not available for iOS applications without a signing key. For more information, see the PhoneGap Build documentation.
- In the PhoneGap Build Service panel, click the QR code for the application you want to download.
- Start the QR code reader on your mobile device and scan the QR code.
- Once the application has finished downloading, you can launch it directly on your device.
- Return to the build list by clicking the Back to Build Panel button.
IMPORTANT: You need to have the Android SDK and/or the webOS SDK/PDK installed before proceeding. You also need to have specified any SDK/AVD information you want available locally from within the SDK applications. For more information, see Set up the Development Environment.
- Open the PhoneGap Build Settings panel by choosing Site > PhoneGap Build Service > PhoneGap Build Settings.
- Specify locations for the Android and/or webOS SDKs and click Save. These locations tell Dreamweaver where to find the information it needs to send your application to the emulator(s).
- In the PhoneGap Build Service panel (Site > PhoneGap Build Service > PhoneGap Build Service), click the Emulate (sideways facing) button for the application you want to emulate.
- If you previously specified your SDK/AVD information from within the SDK applications, a window should appear, pre-populated with information.
- Choose the SDK/AVD you want to use for emulation and click Launch.
Note: Emulators can be notoriously slow. It may take some time for your emulator to launch and load the application.