adobe-marketing-cloud-apps / aem-apps-lab-developer

Project content to accompany the Adobe Marketing Summit developer lab

Building Mobile Apps: Lab

A PhoneGap Enterprise Introduction for Developers

This lab was orginally developed for Adobe SUMMIT 2015. Additional content was added for PhoneGap Day workshops.

Related Links

• Developer Lab Workbook
• Developer Lab Slides

Marketer Lab

A companion lab for marketers was also offered during Adobe SUMMIT 2015.

• Marketer Lab Workbook
• Marketer Lab Slides

Minimum Requirements

• AEM 6.1
• node.js version >=0.10.x
• PhoneGap CLI version >=3.6.0
• (iOS only) Xcode version ==6.1
• (iOS only) ios-sim

Get started

Clone this repository to begin.

git clone https://github.com/Adobe-Marketing-Cloud-Apps/aem-apps-lab-developer.git

Lessons

Lessons associated with this lab can be found in the lessons directory of this repository.

Install

This project is based on the multimodule-content-package-archetype (with the bundle removed for simplicity), so it contains the same helpful profiles and properties to build and deploy your project with maven.

From the project root, run:

mvn -PautoInstallPackage clean install 

... to build the content package and install to a AEM instance. The CRX host and port can be specified on the command line with mvn -Dcrx.host=otherhost -Dcrx.port=5502 <goals>

Edit in AEM

Once built and installed via maven, your new app should be editable in AEM. Take a look at the new Apps admin console to view the available apps on your instance.

A new app folder with the name 'Summit Lab' should be listed. Tap it to view the app you installed. If you followed the instructions exactly and have your author instance running locally on :4502, you should be able to author your new app via the following link:

http://localhost:4502/editor.html/content/phonegap/Geometrixx/ShapesCon/en/home.html

Run on the iOS Simulator

From the Apps console, navigate to your app's Command Center (your URI will differ based on the values you provided to customize-app.sh).

Locate the 'PhoneGap Build' tile, and the down arrow to the top right of the pane. Tap this arrow, then tap the 'Download CLI' item to initiate a download of your app's content. A .zip payload will be downloaded locally. Using your command line of choice, navigate to the directory created by extracting the payload. Using OS X? this handy Finder toolbar app makes it easy.

Using the PhoneGap CLI, build and deploy your application to the iOS Simulator with the following command:

phonegap run ios --emulator

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.

Uninstall

From the package manager console, locate the package named 'summit-developer-lab-content-1.0-SNAPSHOT.zip'. It should be at the top of the list. Uninstall this package to remove your app, it's template, component, design, and supporting clientlibs.

aem-apps-lab-developer's Issues

Beacon demo does not work

Hi,

i'm trying to implement the beacon demo example showed here, same js and html. I debugg the code and it seems to be listening for a "beacon transmitter" but it never find anything. For transmitter as a beacon I'm using the app "Locale" (available in appStore) . The weird stuff here, is that i implemented the sdk estimote in another java class and it worked with the same beacon trasmitter(the app for simulate a beacon transmitter).

I try also to pass a javscript object as region to the method: startRanging(MyRegionObject), but still not working, I figured out the estimote sdk in java uses startRangingBeaconsInRegion(MyRegion) there is something i'm missing or doing in the wrong way?

Please any advice?
Greetings.