Manage App Tile manage-app-tile

CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.
NOTE
Adobe recommends using the SPA Editor for projects that require single page application framework-based client-side rendering (e.g. React). Learn more.

The Manage App Tile on the App Dashboard provides the ability to modify details about the Application. To open the Details page click on the Manage App tile’s details link. From within the Manage App page you can edit the PhoneGap Application Configuration (config.xml) settings and prepare your application for submission to the various application stores.

chlimage_1-116

Understanding the Manage App Tile understanding-the-manage-app-tile

You can drill into each tile in the Manage App tile to view or edit details by clicking the ‘…’ in the bottom right corner.

The Basic tab the-basic-tab

You can edit the Name, Author, Short Description, and the Description for your app from this tab.

chlimage_1-117

The Advanced tab the-advanced-tab

Each mobile application platform describes what data is collected, targeting each application store specifically.

Platforms displayed is driven by the PhoneGap config.xml content:

<widget>
<gap:platform name="ios"/>
<gap:platform name="android"/>
</widget>

Each vendor application store, such as Apple App Store or Google Play Store, for example, requires one or more screenshots of your mobile application in order to display your application details to customers. These screenshots can have strict requirements around dimensions and content (basically they must truly represent the application). AEM Apps provides support for selecting and managing these screenshots for the supported platforms and view port dimensions as required by each vendor’s application store.

NOTE
The AEM Verify app provides the ability to send screenshots directly to your app details in AEM.
See Mobile Quickstart for AEM Verify for more details.

chlimage_1-118

Metadata metadata

NOTE
Once you are familiar with the Manage App tile, see Editing App Metadata to view and edit the metadata.

Common Metadata common-metadata

Every Application should have associated metadata that aids in configuring different aspects of the application. The Manage App page is separated into two different areas related to metadata collection. Platform specific metadata and common metadata.

There is common configuration and metadata to all platforms.

Within this section you define the Content Update Server URL, landing page for your mobile application, PhoneGap version for compilation, your application version, name, description and more.

App Version is the working version of your application. Common best practice is to use a 3-decimal notation and start below 1.0.0 prior to your first release.

PhoneGap Version is the version in which you wish to compile your application with PhoneGap. Best practice is to keep up with the current version in order to ensure you get the latest and greatest features and bug fixes.

Content Update Server URL is the URL which your application will use to call for ContentSync updates. It must be set to your dispatcher URL or, if not using a dispatcher, to one of your publish instances that will be used to serve ContentSync updates to your application.

chlimage_1-119

NOTE
This section may appear empty unless there is data populating the fields.
At the top of the details view, you’ll see Application Version, PhoneGap Version and Update URL, each of these values can be set within Common Metadata section. However, the Application ID cannot be edited.

Platform Metadata platform-metadata

Every platform that’s defined in the PhoneGap config.xml can contain custom platform properties. An AEM developer must contribute the content structure to capture these properties. A provided example of platform specific properties can be found for iOS.

Metadata for all configured platforms is now displayed at the same time on the Advanced tab of the Manage App tile.

NOTE
The platform metadata sections are not used by PhoneGap during a CLI or Remote PhoneGap build, but rather AEM attempts to capture metadata for platforms such that they can be used later on when submitting to the targeted vendor’s application store.

For platforms which are not understood by AEM, it is still possible for a AEM developer to extend the UI to capture this metadata which later on can be exported and used during the application submission process.

iOS Metadata ios-metadata

The Apple AppStore requires additional metadata in order to submit your application for distribution. The iOS metadata section attempts to collect the required information that can be used by Apple’s iTMSTransporter tool to publish the metadata to the associated Apple developer’s account.

To obtain the Apple specific metadata you first need to create your application on https://itunesconnect.apple.com. Upon creating your application Apple will generate metadata which is required by the iOS metadata section if you wish to use the Apple iTMSTransporter tool to validate and upload the metadata to itunesconnect.apple.com. If you just want to obtain the metadata to collect you don’t necessarily need to fill out the iOS specific metadata. You can still export the metadata that will merge the iOS and common metadata and collect all the screenshots into a zip file that can be downloaded at any time.

The downloaded zip file contains an itmsp file which can be inspected for the metadata.xml. The itmsp file contains the exported metadata (within the metadata.xml file), along with all the associated screenshots.

The export functionality is used to provide a convenient way of collecting the screenshots and metadata that can be passed along to the application publisher for input into the vendor specific application store.

chlimage_1-120

Android Metadata android-metadata

When selecting the Android platform, there is no custom metadata at this point that can be set. When clicking on the download button as zip file will be generated with a properties file that contains all the metadata and associated screenshots.

The export functionality is used to provide a convenient way of collecting the screenshots and metadata that can be passed along to the application publisher for input into the vendor specific application store.

chlimage_1-121

Content Update Server URL content-update-server-url

One of the key features of AEM Apps is the ability to have a mobile application request new content through ContentSync, where content can be html resources, pages, video, images, text and more. Once a content author has updated content and then publishes that content the server makes the content update available for the mobile application to download.

The Content Update Server URL property is the URL that must point to a publish instance; either directly or through the dispatcher or CDN. The format of the URL is simply:

https://[hostname]:[port]

NOTE
If your Author server instance is replicating to multiple publish server instances (common architecture for AEM), each publish server will have the same update content because the update is built on the author and replicated to all publish instances. Basically, load balancing and failover is fully supported.

The Plugins tab the-plugins-tab

The Plugins tab describes the plugins associated with your app. This information will be used to retrieve the appropriate plugin during a build.

chlimage_1-122

The Screenshots tab the-screenshots-tab

The Screenshots tab displays the supported screenshot resolutions on different platforms.

chlimage_1-123

NOTE
To add and remove screenshots, see Editing App Metadata.

The Authentication tab the-authentication-tab

The Authentication tab allows you to select an OAuth client to be assoicated with your application and enables a developer to utilize Adobe Experience Manager’s OAuth authentication.

chlimage_1-124

The Next Steps the-next-steps

Once you have learnt about Managing App Tile in the application dashboard, see the following resources for other authoring roles:

Additional Resources additional-resources

To learn about the roles and responsibilities of an Administrator and Developer, see the resources below:

recommendation-more-help
547b817b-14b5-4d82-aa0f-a64750e0e592