The PhoneGap Build Tile on the application dashboard provides the ability to build and distribute your PhoneGap mobile application through the Adobe PhoneGap Build Service.
All supported platforms defined within the Manage App tile will be built with PhoneGap Build when pushing a remote build with the PhoneGap Build Tile.
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 have verified your PhoneGap Build account is active, navigate to your AEM Cloud Management Console, specifically the PhoneGap Build Cloud Service (http://localhost:4502/etc/cloudservices/phonegap-build.html).
Use the Manage Cloud Services tile to configure a new cloud service configuration.
Before starting to build your app using PhoneGap Build tile, you must configure your cloud services, using the Manage Cloud Services tile from the AEM Mobile dashboard.
To configure cloud services for your app, follow the steps below:
Once you have configured the cloud services, you can build your application with PhoneGap Build tile. Click on the top right corner to choose from the Build Remote or Download Source options.
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.
PhoneGap provides a command line interface to build your application locally.
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 will 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, ...)
add --emulate at the end of this line if you don't want to run it on your connected device.
Once you have verified that the above works, use the PhoneGap Build Tile to Download Source. Save and unzip the file onto your local system. Once that is done:
- navigate to that saved file (folder)
- run 'phonegap run ios' (or android, etc)