Configuring the Cloud Service

In order to take advantage of PhoneGap Build you need to configure the AEM PhoneGap Build Cloud Service with your PhoneGap Build account information.

If you don't currently have an account, navigate to https://build.phonegap.com and sign up! If you have an Adobe Creative Cloud membership, you may have support for up to 25 private apps (non-open source apps).

Once you've verified your PhoneGap Build account is active, nativigate to your AEM Cloud Management Console, specifically the PhoneGap Build Cloud Service (http://localhost:4502/etc/cloudservices/phonegap-build.html). You can quickly navigate directly to this URL through the PhoneGap Build tile by clicking the chevron and selecting, 'configure'. From here click the wrench button (see images below).

PhoneGap Build Tile with Configure Option Selected

From the PhoneGap Build Tile, select the 'Configure' option.

In the Configure PhoneGap Build Modal Window (screenshot below), click on the 'Select a PhoneGap Build Configuration' drop-down list. If the configuration you would like to use is not available, click the 'Manage the PhoneGap Build Configurations' button to navigate to the PhoneGap Build Cloud Service Configuration and create a new service.

Configure PhoneGap Build Modal Window

From within the PhoneGap Build Cloud Service (screenshot below), hit the '+' icon to configure a new cloud service configuration for your PhoneGap Build service.

From within the create configuration dialog, give the configuration a title (e.g. Geometrixx Corporation as seen below) and hit the 'create' button.

When prompted, enter your build.phonegap.com account information.

Finally, navigate back to the AEM Command Center and select the PhoneGap build configuration you just created and will now be displayed within the 'Select a PhoneGap Build Configuration' drop-down list (screenshot above). Click 'Update' button and you've completed the configuration of your build tile cloud service.

PhoneGap Build Cloud Service

Building your Application with PhoneGap Build

Once you've configured your PhoneGap build tile and service, you can now invoke a remote build with Adobe PhoneGap Build.

From the PhoneGap build tile, click 'Build Remote' (see image below).

If the build fails for any reason (red iOS icon below indicates that platform failed), you can hover over the icon to get the error message. Alternatively, you can click the triple dot, '...' at the bottom of the tile to navigate directly to https://build.phonegap.com (you must authenticate) and watch and manage your build directly.

AEM Command Center PhoneGap Build Remote

Building your application with PhoneGap CLI

Compile the PhoneGap application on your computer using the PhoneGap Command-line Interface (CLI). To include the AEM content into your application, AEM creates a ZIP file that contains the content of your mobile application, Content Sync configurations, and other required assets. Download the ZIP file and include it in your build.

In order to take advantage of PhoneGap's command-line-interface, you'll need to set-up your local environment to include:

Once you've installed the pre-requisites, give it a simple test by creating a simple app and getting it running either in your simulator or better yet on your device, from a terminal try:

phonegap create myApp

cd myApp

phonegap run ios (or android, ...)

(note: add --emulate at the end of this line if you don't want to run it on your connected device).

Once you've verified that the above works, use the PhoneGap Build Tile to 'Download CLI'. Save and unzip the file onto your local system. Once that's done the rest is as simple as navigating to that saved file (folder) and running 'phonegap run ios' (or android, etc).

Twitter™ and Facebook posts are not covered under the terms of Creative Commons.