AEM Apps / PhoneGap Enterprise Hello World

This project contains an AEM Apps project demonstrating the simplest PhoneGap Enterprise application possible. The "Hello World" of AEM Apps. It is intentionally not particular attractive. It can be considered the opposite of the Kitchen Sink sample app.

A detailed guide to the anatomy of this project can be found here.

Features

The application includes:

• Over the Air (OTA) content updates (using a manual button press)
• Lifecycle & Action tracking with Adobe Mobile Services
• In-App Messaging with Adobe Mobile Services

Requirements

• AEM 6.1 with Apps Feature Pack 2
• NodeJS 0.10.x+ (not 4.x)
• One of:
  • cordova CLI 5.3.1+ (Installation Instructions)
  • phonegap CLI 5.3.4+ (Installation Instructions)
• Adobe Mobile Services account (optional)

Apps Feature Pack 2

This application now requires the installation of AEM 6.1 Apps FP2. You can download this feature pack from Package Share. There are also updates for the sample applications, available as a separate package

Usage

1. Install both content packages by running this command from the project root:

   $ mvn -PautoInstallPackage clean install

2. Navigate to the Apps Control Center, i.e. open http://localhost:4502/libs/mobileapps/admin/content/dashboard.html/content/phonegap/helloworld/shell in your browser.

3. (Optional) Configure Adobe Mobile Services

4. Download the Application Source (using the dropdown menu in the PhoneGap Build section).

5. Unzip the resulting zip file.

6. Add the appropriate PhoneGap/Cordova platforms, e.g.

   $ phonegap platform add ios

7. Run/emulate the application, e.g.

   $ phonegap emulate ios

Updating

To update the content within the application:

1. Ensure you have an AEM publish instance running and that the Update URL in the AEM App is properly configured.
2. Modify the home screen in AEM Apps (e.g. change the text or add an image).
3. Stage and Publish a content update.
4. Within the application, click the Check for Update button.