AEM Apps Kitchen Sink

🆕 Note that the requirements have changed as of November 2014. If you do not have the Apps featurepack installed, please use the release/6.0 branch.

A PhoneGap API showcase app managed in AEM.

What is this?

An AEM App which demonstrates the usage of various Cordova/PhoneGap API's, implemented as authorable components in an application that can be updated over-the-air. This app was originally built to accompany my talks at SUMMIT and AEMHub, but has lived on as a companion to the AEM Apps Starter Kit.

Background: So, you want to build an app

Requirements

• AEM 6.0, with:
  • Service Pack 1 installed
  • Apps Feature Pack 1 installed
  • Geometrixx Apps update installed
• node.js version >=0.10.x
• PhoneGap CLI version >=3.6.0
• (iOS only) Xcode version ==6.1
• (iOS only) ios-sim
• (Android only) Android SDK

Building

This project uses Maven for building and installation to AEM. Common commands:

From the project directory, run mvn -PautoInstallPackage clean install to build the bundle and content package and install to a AEM instance.

Viewing and editing app pages

Open up the AEM Apps console (assumes you have an author instance running locally on :4502) to view your installed apps. Tap 'Kitchen Sink Shell' to open up the command center for this app.

In the 'Content' tile, tap the 'Kitchen Sink English' item to browse the content hierarchy and make changes (or additions) to the app's content.

Demo scenarios

I've added a few demo scenarios to the demos directory of this repository.

Using with VLT

To use vlt with this project, first build and install the package to your local AEM instance as described above. Then cd content/src/main/content/jcr_root and run

vlt --credentials admin:admin checkout -f ../META-INF/vault/filter.xml --force http://localhost:4502/crx

Once the working copy is created, you can use the normal vlt up and vlt ci commands.

Specifying CRX Host/Port

The CRX host and port can be specified on the command line with:

mvn -Dcrx.host=otherhost -Dcrx.port=5502 <goals>

Credits

• Compass designed by Jay Proulx
• Sink (app icon) designed by Arthur Shlain from the Noun Project