19 March 2012
User level: All
Additional required other products (third-party/labs/open source)
Note: If you have questions about this article, use the comments feature at the bottom of the article. Please don’t contact technical support with questions about Adobe Developer Connection articles.
Increasingly, Adobe Digital Publishing Suite customers want to deploy viewer applications directly to employees or to members of their organization rather than through the application store. Apple allows you to distribute iOS applications using an enterprise distribution provisioning profile. When you use this profile, you do not have to distribute an application through the application store. Rather, your end users can download and install an application from a web page. This tutorial explains how to create an enterprise viewer application and set up a web page for authorized users to download and install it. To make use of enterprise distribution, you must have a web server that can host three files: enterprise_viewer.plist, index.html and your .ipa (viewer app).
Follow the steps below to learn how to create an enterprise viewer using Viewer Builder.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>items</key> <array> <dict> <key>assets</key> <array> <dict> <key>kind</key> <string>software-package</string> <key>url</key> <string>absolute-path-to-ipa</string> </dict> </array> <key>metadata</key> <dict> <key>bundle-identifier</key> <string>com.adobe.dps.enterpriseViewer</string> <key>bundle-version</key> <string>184.108.40.206.0</string> <key>kind</key> <string>software</string> <key>title</key> <string>Enterprise Viewer</string> </dict> </dict> </array> </dict> </plist>
url(line 14) to replace “absolute-path-to-ipa” with the absolute URL to where you will host your IPA file.
bundle-identifier(line 20) to replace “com.adobe.dps.enterpriseViewer” with the bundle identifier of your application. If you do not have the bundle identifier, open Viewer Builder and find the Bundle ID in the Build Details column for your viewer.
bundle-version(line 22) to replace “220.127.116.11.0” with the Bundle Version of your application. If you do not have the Bundle Version, open Viewer Builder and find it in the Build Details column for your viewer (example in Figure 2).
You are now ready to host your viewer application and its associated files for distribution.
In the following section, you will learn how to create the HTML page for users to download your application, upload files for that page, and test the files.
<a href="itms-services://?action=download-manifest&url=<absolute-url-to-plist>">Download and install</a>.
<absolute-url-to-plist>with the absolute path location where you are hosting the enterprise_viewer.plist file.
When using this method to distribute your applications, Apple requires that you authenticate users or host the files behind a firewall. Your authentication can be as simple as using basic authorization or a directory-based authentication. The following links detail how to set up basic authentication for common web servers:
This tutorial provided step–by-step instructions on how to create an enterprise-provisioned viewer application and an HTML page for enterprise distribution. For more information and tutorials about Digital Publishing Suite.
This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License. Permissions beyond the scope of this license, pertaining to the examples of code included within this work are available at Adobe.