/aem-phonegap-kitchen-sink

A PhoneGap API showcase app managed in AEM

Primary LanguageJavaMIT LicenseMIT

AEM Apps Kitchen Sink

🆕 Note that the requirements have changed as of June 2015. If you do not have AEM 6.1, please use the release/6.0-apps-featurepack 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

Testing

Download PhantomJS and add it to your path.

Install the testing dependencies with npm:

npm install

To run the Jasmine tests with Karma, use maven:

mvn test

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.

Don't have the required testing tools installed? You can skip the tests with mvn -PautoInstallPackage clean install -DskipTests

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