This document is part of the Getting Started with AEM Mobile Guide, a recommended starting point for AEM Mobile reference.
Once content has been produced and the app is ready to be tested, use the power of Adobe PhoneGap Build with AEM Mobile to quickly and easily build your mobile application.
This is typically a role for AEM Administrator, as it involves configuring a connection to Adobe PhoneGap Build (an AEM cloud service configuration), and building the app through the PhoneGap Build Tile found in the AEM Mobile Application Console. This tile provides the ability to build and distribute a Mobile application through the Adobe PhoneGap Build Service, including signing your application and distribution. All supported platforms defined within the Application Details tile will be built.
Note: AEM Administrators have the option of pushing a remote build to https://build.phonegap.com while AEM Developers can directly download the source to build locally with PhoneGap CLI for rapid development.
Finally, AEM Administrators may wish to submit their newly built applications to online marketplaces for Apple, Google and Windows.
AEM Developers may wish to use PhoneGap command line tools to build the app locally. This is useful for hands on device testing.
In order to take advantage of Adobe 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 register. If you have an Adobe Creative Cloud membership, you may have support for up to 25 private apps (non-open source apps). To begin, select the + from the Manage Cloud Services tile as shown below:
Once submitted, you'll be returned to your applications dashboard (console). Notice the Adobe PhoneGap Build tile has been updated and is now aware of the new cloud service connection.
Once you've configured your PhoneGap build tile and service, you can now invoke a remote build with Adobe PhoneGap Build.
From the Adobe 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, '...' (ellipses) at the bottom of the tile to navigate directly to https://build.phonegap.com (you must authenticate) and watch and manage your build directly.
Releasing a AEM App built with Adobe PhoneGap Build involves various processes to submit within the guidelines and policies of different "marketplaces" for Apple, Google and Windows.
A PhoneGap workshop has outlined the required steps for each store.
Adobe PhoneGap provides a command-line-interface to build your application locally, which is useful for on-device testing.
Compile the Adobe PhoneGap application on your computer using the Adobe 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, ContentSync configurations, and other required assets. Download the ZIP file, expand and use PhoneGap CLI to build locally.
In order to take advantage of PhoneGap's command-line-interface, you'll need to set-up your local environment to include:
- Platform SDK (iOS, Android, WindowsPhone, ...) and,
- PhoneGap CLI
- phonegap create myApp
- cd myApp
- phonegap run ios (or android, ...)