This document is part of the Getting Started with AEM Mobile Guide, a recommended starting point for AEM Mobile reference.
AEM Mobile apps are based on a blueprint that defines a page structure and properties. You can configure the following application properties:
- Title: The application title.
- Destination Path: The location in the repository where the application is stored. Leave the default to create a path based on the app name.
- Name: The default value is the value of the Title property with space characters removed. The name is used within AEM to refer to the application, for example for the repository node that represents the application.
- Description: A description of the application.
- Server URL: The URL that provides Over-the-Air (OTA) content updates to the application. The default value is the publish server URL of the instance that is used to create an application (taken from the externalizer service). Note, this must be a publish server instance rather than an author, which requires authentication.
You can also provide an image file to use as the application thumbnail, select the PhoneGap Build configuration to use, and select the Mobile App analytics configuration to use. This image is only used as a thumbnail to represent your mobile application within the mobile apps console in Experience Manager.
Additional (and optional) tabs exist for build cloud service and integrating the Adobe Mobile Services SDK plug-in into your app.
- Build: Click manage configurations and set up your build.phonegap.com build service here. Then from the drop-down you will be able to select the newly created PhoneGap build cloud service.
- Analytics: Click manage configurations and set up your Adobe Mobile Services SDK cloud service. Then from the drop-down you will be able to select the newly created Mobile Service to integrate into your mobile app.
Using App Templates
App templates provide an easy way to leverage existing designs created by devlopers, used for the creation of new apps within AEM.
What is an app template? Think of it as a collection of page templates and components that represent a baseline or foundation of an app.
When creating a new app based on the template of another app, you will get an app that has a starting point representative of the app in which it was created from.
You must have an existing mobile app template (or an app installed that has an app template) to make use of this feature.
The latest AEM Apps samples package includes an updated version of the Geometrixx app with an app template. Alternatively, you can install the StarterKit which also provides a template.
Steps to creating a new app based on an app template:
- Navigate to the AEM Mobile app catalog: <server-url>/aem/apps.html/content/mobileapps
- Select Create App as shown below
Select an app template made available to you by an AEM developer. See Structure of an AEM Mobile App for developer assistance.
Fill out your new app's details as needed including optionally changing its thumbnail image. These values can be edited later from the Manage App tile.