Manage App Tile manage-app-tile
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.
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.
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.
Metadata 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.
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.
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.
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.
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]
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.
The Screenshots tab the-screenshots-tab
The Screenshots tab displays the supported screenshot resolutions on different platforms.
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.
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: