๐ Note that the requirements have changed as of September 2015. If you do not have AEM 6.1 + FeaturePack 2, please use the release/6.1
branch.
A PhoneGap API showcase app managed in AEM.
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
- AEM 6.1
- Apps FeaturePack 2.0.12
- Apps Samples 2.0.8 (optional; updates Geo samples)
- Apache Maven version
>=3.1.1
- node.js version
>=0.12.x
- Cordova CLI version
==5.3.1
(install exact version withnpm install -g [email protected]
) - (iOS only) Xcode version
>=6.3.1
- (iOS only) ios-sim
- (Android only) Android SDK
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
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
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.
I've added a few demo scenarios to the demos directory of this repository.
To use vlt with this project, first build and install the package to your local AEM instance as described above. Then cd content-dev/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.
The CRX host and port can be specified on the command line with:
mvn -Dcrx.host=otherhost -Dcrx.port=5502 <goals>
To stage an update to the kitchen-sink en
content package (note newupdate
selector):
curl --user admin:admin --data-urlencode "title=new update" http://localhost:4502/content/phonegap/kitchen-sink/en/jcr:content/pge-app/app-config.newupdate.json
To publish all staged updates of the kitchen-sink en
content package (note activateZips
selector):
curl --user admin:admin --data-urlencode "title=activate it" http://localhost:4502/content/phonegap/kitchen-sink/en/jcr:content/pge-app/app-config.activateZips.json
- Compass designed by Jay Proulx
- Sink (app icon) designed by Arthur Shlain from the Noun Project