Professional Documents
Culture Documents
A Companion Guide
This document describes how to create the certificates and files you need to include as part of your viewer submission to Apples App Store. For Viewer Builder 1.8. Please note that Apple governs the app submission process. You need to use a Mac OS computer to create the certificates required for the submission.
In This Guide
Legal Notice 2 Publishing Process Overview
Types of Viewer Apps 2 Entitlement and Fulfillment 3 Guidance for Multi-Issue Apps 3
Workflow Overview for Creating a Single-Issue App (Single Edition) 4 Workflow Overview for Creating Viewer Apps (DPS Subscribers) 5 Workflow Overview for Creating Subscription Viewer Apps 6 Checklist Items Required by the Viewer Builder 7 Becoming an Apple Developer 8
Signing up for a retail account 8 Creating an App ID 8
Creating Certificates 9
Viewing videos on creating certificates 10 Creating a development certificate 10 Creating a .p12 developer certificate 12 Creating a developer mobileprovision file 13 Creating a distribution certificate 15 Creating a .p12 distribution certificate 16 Creating a distribution mobileprovision file 16 Testing your certificates 17 Creating a push notification certificate 18 Creating a .p12 APN certificate 20
Setting up Apple Push Notification Service (Optional) 17 Types of Retail Content 21 Creating In-App Purchases for Retail Folios 22 Setting up Subscriptions and Entitlement 24
What subscriptions look like in the custom Viewer 25 Setting up entitlements with a third-party subscription management provider (Enterprise only) 25 Understanding iOS subscriptions 26 Creating iOS subscription assets 27 Creating in-app purchases for retail Apple subscriptions 28 Creating an in-app purchase for a free Apple subscription 30 Enabling an app for Newsstand 31
Testing the Development App for a Single-issue Viewer 32 Testing the Development App for a Multi-folio Viewer 32 Submitting the Distribution App to the Apple Store 33 Testing retail issues in the sandbox 37
Submitting Apps to the Apple Store 33 Updating a Viewer App 39 Creating Additional Viewer Apps 39 Common iPad Publishing Issues 39
Legal Notice
The contents of this guide is Adobe Confidential and subject to the terms of the Terms of Use, is furnished under license and may be used or copied only in accordance with the terms of such license. No part of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe Systems Incorporated. Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end user license agreement. The content of this guide is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies that may appear in the informational content contained in this guide. Please remember that existing artwork or images that you may want to include in your project may be protected under copyright law. The unauthorized incorporation of such material into your new work could be a violation of the rights of the copyright owner. Please be sure to obtain any permission required from the copyright owner.
ADOBE CONFIDENTIAL
Entitlement and Fulfillment Entitlement is the permission to download an item. Fulfillment is the process of making entitled content available to customers for downloading. The Apple App Store is where customers can download the viewer app. You use the Viewer Builder to create custom apps that you submit to the Apple Store. The Distribution Service is where folios are available for downloading. You use the Folio Producer to publish folios to the Distribution Service. When customers download your viewer app from the store and open the library, the viewer checks the Distribution Service for folios that are available for downloading. For retail folios, the viewer checks with Apple (or the custom entitlement server) to determine whether customers are entitled to download folios. Guidance for Multi-Issue Apps Every person working on the publication should use the same version of the digital publishing tools throughout the process. Incompatibility issues may arise if, for example, a custom viewer app is built using one version of the tools and a folio for that viewer app is published using a newer version of the tools. For best results, make sure that your multi-issue viewer app includes preview content that represents any retail folio for sale. The preview folio may include a table of contents and several articles. For guidance regarding app approval requirements, contact Apple. You cannot use the same Adobe ID to create multiple multi-issue viewer apps. Create a different Adobe ID for each app, and use the appropriate Adobe ID when you publish the folio to the Distribution Service. Use the Account Administration tool on the DPS Dashboard to assign the application role to an Adobe ID. You can use the same certificates for different apps. However, you must create a new App ID and new mobileprovision files for each viewer app.
ADOBE CONFIDENTIAL
ADOBE CONFIDENTIAL
ADOBE CONFIDENTIAL
ADOBE CONFIDENTIAL
Splash images When the viewer is started, a splash screen appears for approximately three seconds. Create two splash screen PNG images. The dimensions should be 1024x768 and 768x1024. For best results, make your splash image different from your cover. If the cover and the splash screen are identical, users may think the app is frozen when they first start it.
Adobe Publishing Process for iPad Apps ADOBE CONFIDENTIAL Viewer Builder 1.8 Page 7
Certificates and mobileprovision files Apple requires a .p12 certificate and mobileprovision file for both the development and distribution apps. To obtain the certificates and mobile provision files, use the Apple iOS Provisioning Portal, as described later in this companion guide.
Creating an App ID A different App ID is required for each viewer app you create. You cannot edit or delete the App ID. 1. Go to http://developer.apple.com. 2. Click iOS Dev Center, and log in using your Apple developer ID. 3. Click iOS Provisioning Portal on the right side of the iOS Dev Center window. 4. Click App IDs. 5. Click New App ID, and then do the following: Type a description, such as the name of your magazine. Leave Bundle Seed ID set at Generate New (for first App ID) or Use Team ID (for additional App IDs). Specify a Bundle Identifier. Use a namespace format to create the Bundle Identifier in the form of com.publisher.publication.
Adobe Publishing Process for iPad Apps ADOBE CONFIDENTIAL Viewer Builder 1.8 Page 8
Creating an App ID
6. Click Submit. The App ID appears in the list. Note: Do not select the Enable for iCloud option. Custom viewer apps cannot backup .folio files to the cloud. To make sure this is turned off, click Configure next to the App ID you created and turn off Enable for iCloud.
Creating Certificates
Apple requires all applications to be signed by a valid certificate before they can be run on the iPad. Certificates. The Viewer Builder needs to create two different Viewer appsa development app and a distribution app. The development app is for testing; the distribution app is what youll submit to Apple once youve tested and approved the development app. The development app and distribution app requires its own certificate, and each certificate requires its own .p12 certficate and mobileprovision file. .p12 certificates. The .p12 file saves your certificate private key information and lets Viewer Builder create a signed application. Creating the .p12 certificate requires you to create and download a certificate and then use the Keychain Access utility to export the private key of that certificate as a .p12 certificate. Dont worryits not as complicated as it sounds. You will create separate a .p12 certificate for the developer certificate and the distribution certificate. You can use the development and distribution certificates for multiple apps. They are not tied to the App ID. If you want to enable the Apple push notification service (APN), create a separate certificate that you can upload to the Adobe fulfillment server. See the section on setting up push notifications for details. mobileprovision file. The mobileprovision file determines which iPads can install and use your Viewer app. The mobileprovision file for the development app includes a list of iPad IDs called UDIDs. You will create separate mobileprovision files for the development certificate and distribution certificate. The mobileprovision file for the distribution certificate does not include any UDIDs.
ADOBE CONFIDENTIAL
The mobileprovision files are tied to the App ID. Create a pair of development and distribution mobileprovision files for each Viewer app. Viewing videos on creating certificates Apple provides several videos that explain the certificate-creation process. Click the video links on the right side of the iOS Provisioning Portal. Creating a development certificate 1. Go to the iOS Provisioning Portal page. Sign to the Apple Developer site, navigate to the iOS Dev Center, and then click iOS Provisioning Portal. 2. Click Certificates on the left side of the window. Notice that that are separate tabs for Development and Distribution. You will create the Development certificate files first. 3. Make sure that the Development tab is selected.
To create a development certificate, use the Keychain Access utility to create a certificate signing request (CSR).
Adobe Publishing Process for iPad Apps ADOBE CONFIDENTIAL Viewer Builder 1.8 Page 10
5. Open the Keychain Access utility. The Keychain Access utility is found in the Utilities folder of your Applications folder. 6. Make sure that no existing keys or certificates are selected, and choose Keychain Access > Certificate Assistant > Request a Certificate from a Certificate Authority.
7. Specify a valid email address and a common name (such as your name or the publishers name). Select Saved to Disk. Click Continue.
It isnt necessary to select Let me specify key pair information, but if you do select this option, specify 2048 bits and RSA. 8. Specify the name of the certificate signing request and where the file will be saved, and click Save.
Now that youve created the certificate signing request file, you need to submit it to the Provisioning Portal to create the required development certificate. 10. In the iOS Provisioning Portal, click Choose File, and double-click the certificate request file you just saved. Click Submit.
Adobe Publishing Process for iPad Apps ADOBE CONFIDENTIAL Viewer Builder 1.8 Page 11
Your development certificate is added to the Provisioning Portal. A message will also be sent to the email address you specified. 11. To update the status from Pending issuance, click a different tab and then click the current tab again. The status should change to Issued.
12. Click Download, and then download the certificate to a known location. This development certificate is called developer_identity.cer. This file is required to create your .p12 certificate. Creating a .p12 developer certificate 1. In Finder, locate the developer_identity.cer file you created, and double-click it. Double-clicking the certificate launches Keychain Access and installs the certificate. If double-clicking the .cer file does not install the certificate as shown, use the File > Import Items method to specify the .cer file.
Certificate added to private key (click the arrow to expand the private key)
2. Control-click the private key associated with your certificate (see red arrow above), and click Export [name].
Adobe Publishing Process for iPad Apps ADOBE CONFIDENTIAL Viewer Builder 1.8 Page 12
Important: Control-click the private key, not the certificate below the private key. 3. Save your key in the Personal Information Exchange (.p12) file format. Specify a name that distinguishes it from the .p12 file youll create for the distribution certificate.
4. When prompted, specify a password for your .p12 certificate, and click OK. Do not use a blank password. You will provide this password in the Viewer Builder. (You can use the same password for the distribution and development certificates.) 5. Specify the password for your computer, and click Allow. The .p12 certificate is saved for the development certificate. Youll need to specify this .p12 file, along with the password, when using the Viewer Builder. Creating a developer mobileprovision file The mobileprovision file allows specified devices to use the application. To create a mobileprovision file for the development certificate, you first specify the iPads you want to provision in the Devices section. Then you add those devices in the Provisioning section. If youre enabling push notifications, configure your App ID before you create the mobileprovision file. Otherwise, youll need to create new mobileprovision files. See Setting up Apple Push Notification Service later in this document. Note: Do not use asterisks (*) or other special characters when creating your mobileprovision files. 1. Go to the iOS Provisioning Portal page. 2. Click Devices on the left side of the window. 3. Click Add Devices, and then specify the device names and their UDIDs. You can find out your devices UDID in XCode or in iTunes. (In iTunes, select the device, click Serial Number to display the UDID, and then press Command+C to copy.)
ADOBE CONFIDENTIAL
4. Click Provisioning on the left side of the window, and then click New Profile. 5. Specify the Profile name (include Dev in the name to distinguish it from the distribution file), select the certificate, choose the App ID, and specify the devices you want to provision.
6. Click Submit.
7. Click Download, and then save the .mobileprovision file to your assets folder. You have now created the files that the Viewer Builder needs to build the development app.
ADOBE CONFIDENTIAL
Creating a distribution certificate 1. On the iOS Provisioning Portal page, click Certificates. Notice that that are separate tabs for Development and Distribution. You will create a Distribution certificate. 2. Click the Distribution tab.
First, create a certificate signing request file that will be used to create the required certificate. 3. Click Request Certificate. 4. Open the Keychain Access utility. The Keychain Access utility is found in the Utilities folder of your Applications folder. 5. Make sure that no keys or certificates are selected, and choose Keychain Access > Certificate Assistant > Request a Certificate from a Certificate Authority. 6. Specify a valid email address and a common name. Select Saved to Disk. Click Continue. 7. Specify the name of the certificate signing request and where the file will be saved, and click Save. 8. When the certificate is created, click Done. A private key and public key are added for the distribution certificate. You will now use this certificate signing request to create the required distribution certificate. 9. In the iOS Provisioning Portal, click Choose File in the Distribution tab, and doubleclick the distribution certificate request file you just saved. Click Submit. Your distribution certificate is added to the Provisioning Portal. A message will also be sent to the email address you specified. 10. To update the status from Pending issuance, click a different tab and then click the current tab again. Make sure that the Distribution tab is selected. The status should change to Issued. 11. Click Download, and then download the distribution certificate to the folder containing the required files. This distribution certificate is called distribution_identity.cer. Adobe requires this file to build your app. Next, you will create a .p12 certificate for this distribution certificate.
ADOBE CONFIDENTIAL
Creating a .p12 distribution certificate 1. In Finder, locate the distribution_identity.cer file you created, and double-click it. Double-clicking the certificate launches Keychain Access and installs the certificate. 2. Control-click the private key associated with your distribution certificate (not your development certificate), and click Export [Name]. Important: Control-click the private key, not the certificate below the private key. 3. Save your key in the Personal Information Exchange (.p12) file format. Specify a name that distinguishes it from the .p12 file you created for the development certificate. 4. When prompted, specify a password for your .p12 certificate, and click OK. Do not use a blank password. You will provide this password when using the Viewer Builder. (You can use the same password for the distribution and development certificates.) 5. Specify the password for your computer, and click Allow. The .p12 certificate is saved for the distribution certificate. Youll need to provide this .p12 file to Adobe, along with the password, when using the Viewer Builder. Store the .p12 certificate file in a safe place. Creating a distribution mobileprovision file The mobileprovision file allows specified devices to use the application. To create a mobileprovision file for the distribution certificate, you do not specify any device IDs in the Devices section. You simply create the mobileprovision file. If youre enabling push notifications, configure your App ID before you create the mobileprovision file. Otherwise, youll need to create a new mobileprovision file. See Setting up Apple Push Notification Service later in this document. 1. Go to the iOS Provisioning Portal page. 2. Click Provisioning, click the Distribution tab, and then click New Profile. 3. For Distribution Method, choose App Store. 4. Specify the Profile name (include Dist in the name to distinguish it from the development file). 5. Select the certificate, and choose the App ID.
ADOBE CONFIDENTIAL
No devices can be selected when creating a mobileprovision profile for a distribution certificate.
6. Click Submit. 7. Click Download, and then save the .mobileprovision file to a known location. You have now created the .p12 certificates and mobileprovision files that the Viewer Builder needs to build the development and distribution apps. Store these files in a safe place.
Testing your certificates Please test your p12 certificates by adding each of them to your keychain, if you have not already done so. To do this, double-click each .p12 file and enter your password in the Keychain Access utility. When you have entered your password, you should see the certificate in your login keychain. Expand it in the utility, and make sure that it has a name that starts with iPhone Distribution or iPhone Developer. If Viewer Builder does not accept your certificates, re-create your p12 certificates.
These instructions provide information on using the push notification service that Adobe is hosting. Adobe does not yet offer third-party push notifications.
ADOBE CONFIDENTIAL
Important: If you have already created an App ID and certificates, you can configure your existing App ID to enable push notifications. You dont need to create new .p12 certificates for the app. However, you do need to create new mobileprovision files for the newly configured App ID. In addition, you need to create push notification .p12 certificates as described in this section. Creating a push notification certificate 1. Go to the iOS Provisioning Portal page. Sign to the Apple Developer site, navigate to the iOS Dev Center, and then click iOS Provisioning Portal. 2. Click App IDs on the left side of the window. 3. Click Configure next to your App ID.
The Viewer Builder lets you specify both development and production (distribution) push notification certificates. Start by creating the distribution certificate. 4. To create a certificate for the the distribution app, click Configure next to Production Push SSL Certificate.
ADOBE CONFIDENTIAL
5. Open the Keychain Access utility. The Keychain Access utility is found in the Utilities folder of your Applications folder. 6. With no keys or certificates selected, choose Keychain Access > Certificate Assistant > Request a Certificate from a Certificate Authority.
7. Specify a valid email address and a common name. Select Saved to Disk. Click Continue.
It isnt necessary to select Let me specify key pair information, but if you do select this option, specify 2048 bits and RSA. 8. Specify the name of the certificate signing request and where the file will be saved, and click Save. 9. When the certificate is created, click Done.
ADOBE CONFIDENTIAL
Now that youve created the certificate signing request file, you need to submit it to the Provisioning Portal to create the required certificate. 10. In the iOS Provisioning Portal, click Continue. Click Choose File, and double-click the certificate request file you just saved. Click Generate.
12. Click Download, and then download the certificate to a known location. This APN production certificate is called aps_production_identity.cer. Next, you will create the .p12 certificate for this certificate that you can specify in the Viewer Builder. Creating a .p12 APN certificate 1. In Finder, locate the aps_production_identity.cer file you created, and double-click it. Double-clicking the certificate launches Keychain Access and installs the certificate. If double-clicking the .cer file does not install the certificate as shown, use the File > Import Items method to specify the .cer file. 2. Control-click the private key associated with your certificate, and click Export
Adobe Publishing Process for iPad Apps ADOBE CONFIDENTIAL Viewer Builder 1.8 Page 20
[name]. Important: Control-click the private key, not the certificate below the private key. 3. Save your key in the Personal Information Exchange (.p12) file format. Specify a name that distinguishes it as a push notification .p12 file. 4. When prompted, specify a password for your .p12 certificate, and click OK. Do not use a blank password. You will provide this password when using Viewer Builder to upload your push certificate. 5. Specify the password for your computer, and click Allow. The production .p12 certificate is saved for the development app required for testing. Youll need to upload this .p12 file along with the password after you use Viewer Builder to create your app. 6. In the iOS Provisioning Portal page, click Done. 7. If necessary, follow similar steps to create a development push notification certificate. Viewer Builder 1.3 requires a development push certificate, but this requirement may be removed. 8. IMPORTANT: Recreate your developer and distribution mobileprovision files using the iOS Provisioning Portal. In the Viewer Builder, select Push Notifications Enabled in the Certificates page, and specify the push notification certificates and passwords. QUICK SUMMARY: To enable push notifications, configure the App ID, create p12 push notification certificates for development and production (distribution) apps, create new mobileprovision files, and specify theses certificates using the Viewer Builder.
ADOBE CONFIDENTIAL
4. Click the viewer application in which you will include retail folios. 5. Click Manage In-App Purchases. If the Manage In-App Purchases option does not appear, you have not signed up for a retail account by adding your bank info and tax info. See Signing up for a Retail Account earlier in this document. 6. Click Create New to create a new in-app purchase. 7. Click the Non-Consumable Select button.
ADOBE CONFIDENTIAL
8. Specify the pricing and language of your issue. Under Details, specify a Reference Name and Product ID. This Product ID must be identical to the Product ID you use when publishing the folio. Use the com. publisher.publication.folio format, such as com.adobe.dpstips.overlays. For best results, use all lowercase letters for compatibility with folios that will also be available for purchase in an Android Market app. Add a language. Under Pricing and Availability, select Cleared for Sale so that you can test the app. Choose the price for your issue. Under Screenshot For Review, specify an image when youre ready to submit your in-app purchase. Before you submit the screenshot, you can test the retail folio in the sandbox, described later in this document. Apple will not review the in-app purchase until you include the screenshot.
9. Click Save. If you did not specify a screen shot, your status is set to Waiting For Screenshot. If you specify the screen shot, your status is set to Waiting for Review if you need to submit the viewer app or In Review if your viewer app is already approved.
ADOBE CONFIDENTIAL
10. In the Folio Producer Organizer (https://digitalpublishing.acrobat.com), publish the folio as Public and Retail using the same Product ID you used when creating the inapp purchase. If your viewer app is already approved, the retail folio does not show up in the viewer library until Apple approves. If your viewer app has not been approved, your first In-App Purchases must be submitted with a new app version. Select them from the In-App Purchases section of the Version Details page in iTunes Connect, and then click Ready to Upload Binary.
ADOBE CONFIDENTIAL
What subscriptions look like in the custom Viewer Landscape view with an entitlement banner and a subscription tile below it.
Portrait view with an entitlement banner and a subscription tile below it.
Setting up entitlements with a third-party subscription management provider (Enterprise only) Setting up a custom entitlement server is beyond the scope of this guide. Contact your Adobe representative for entitlement server requirements, API specifications, custom storefronts, and related information. For basic information about entitlement settings in the Viewer Builder see the Entitlement Details help topic.
ADOBE CONFIDENTIAL
Understanding iOS subscriptions When you create an iOS subscription, you need to use iTunes Connect to create two types of in-app purchasesone for individual retail folios and one for subscription durations. When you click the Manage In-App Purchases link in iTunes Connect, use the Non-Consumable type for retail folios, use the Auto Renewable Subscription type to create retail subscription durations, and use the Free Subscription type for free Newsstand subscriptions.
Create non-consumable in-app purchase for each retail folio. Create an auto-renewable subscription for each subscription duration.
For each in-app purchase, you specify a Product ID. For example, a Product ID for an individual folio could be in the com.publisher.publication.monthyear format. A Product ID for the subscription duration could be in the com.publisher.publication.duration format. For retail folios, you use that same Product ID when you publish the folio using the Folio Producer Organizer. For subscription durations, you specify the Product IDs when stepping through the Viewer Builder panels. Additional information about subscriptions: You can set up a free subscription for Newsstand apps. Your customers have the choice of purchasing your individual folios or purchasing a subscription. If they purchase a subscription, theyre entitled to any folio published between the start date and end date of their subscription. When customers first subscribe, theyre entitled to the most recently published foliofree or retaileven if the folio was published before their start date. If you publish a retail folio as public, it does not appear in the viewer library until Apple approves the in-app purchase and makes it available. However, the DistribuAdobe Publishing Process for iPad Apps ADOBE CONFIDENTIAL Viewer Builder 1.8 Page 26
tion Service does not look to see whether the published folio is actually available. This creates a situation in which your customers can purchase a subscription and not be entitled to any new content until the pending folio becomes available. There is currently a bug that causes the subscription tile to disappear when the most recent folio has been purchased. This bug should be fixed in the next release (v18). The Publication Date setting in the Folio Producer Organizer determines which folios subscribers are entitled to. For best results, edit the Publication Date settings of folios using a consistent date, such as the first day of each month. For details on creating in-app purchases in iTunes Connect, see Submitting Apps to the Apple Store later in this document. Creating iOS subscription assets The custom viewer library includes several areas that let you offer subscription information. Create the following assets to populate these areas. Offline Banner Assets - Create the HTML assets to be used as the banner if the user is not connected to the internet. Zip a single HTML file, one or more image files, and optional CSS files into a .zip file. Portrait Subscription Tile - Create a 331x180-pixel background .png image that describes the Apple subscription when the iPad is upright. The entire tile is active as a button.)
Landscape Subscription Tile - Specify a 468 x135-pixel background .png image that describes the Apple subscription when the iPad is sideways. The entire tile is active as a button.
ADOBE CONFIDENTIAL
Newsstand Cover Images (only for Newsstand apps) - At this time, you specify a Newsstand cover image in both iTunes Connect and the Viewer Builder. In the Viewer Builder, you specify a 96x128 PNG file. In iTunes Connect, you specify a larger PNG file, such as a 1024x768 PNG file (click the info button for details). The cover image you specify in Viewer Builder appears as the default image in Newsstand until it is replaced by a newer cover image of the most recently published folio. For best results, use the app name, not the folio name, in the cover images.
Creating in-app purchases for retail Apple subscriptions Use the In App Purchase process on iTunes Connect to set up Apple subscriptions. Apple calls a subscription an Auto-Renewable Subscription. When you create a subscription, you generate a shared secret, which is a unique code that lets the app communicate with in-app purchase receipts. Specify this shared secret using the Account Administration tool, and then open the Folio Producer Organizer to register the shared secret. You can use the same shared secret for multiple apps. 1. Go to http://itunesconnect.apple.com, and sign in. 2. If you have not already done so, click Contracts, Tax, and Banking and specify the necessary information. 3. Click Manage Your Applications. 4. In the Manage Your Apps page, click the application in which you want to set up subscriptions. 5. Click Manage In-App Purchases.
ADOBE CONFIDENTIAL
6. Click View or Generate a Shared Secret. If a Shared Secret section does not appear on the In-App Purchases page, it means you have not filled out the necessary banking information or you have not accepted the terms of agreement. Click Go Back, and then click the Contracts, Tax, and Banking option. 7. Copy your shared secret code. Use the Account Admininistration tool on the DPS Dashboard to specify your shared secret. After you specify the shared secret information, open the Folio Producer Organizer to trigger the shared secret registration. You can also send your shared secret to dmpubsupport@adobe.com. You can use the same shared secret code for multiple apps. 8. Click Create New. 9. In the Create New In App Purchase page, select Auto-Renewable Subscriptions. 10. Follow the prompts to fill out the rest of the subscription information. You can create multiple durations. For each duration, specify a Product ID. We recommend that you use the com.publisher.publication.duration format, such as com. adobe.dpstips.1year. When you use Viewer Builder to create your subscription app, you specify the Product IDs in the Subscription Details panel. Apple lets you create multiple subscription families. However, for viewer apps, create only one family with multiple durations.
ADOBE CONFIDENTIAL
11. Use the Adobe Folio Producer Organizer to publish retail folios for your subscription application. If you have not already done so, use the in-app purchase method in iTunes Connect to assign a price and Product ID to each folio. Customers can then pay for individual folios or pay for a subscription that entitles them to a range of folios. If your viewer app has not been approved, your first In-App Purchases must be submitted with a new app version. Select them from the In-App Purchases section of the Version Details page in iTunes Connect, and then click Ready to Upload Binary. Creating an in-app purchase for a free Apple subscription Use the In App Purchase process on iTunes Connect to set up a free subscription for Newsstand apps. When you create a subscription, you generate a shared secret, which is a unique code that lets the app communicate with in-app purchase receipts. Specify this shared secret using the Account Administration tool, and then open the Folio Producer Organizer to register the shared secret. You can use the same shared secret for multiple apps. 1. Go to http://itunesconnect.apple.com, and sign in. 2. If you have not already done so, click Contracts, Tax, and Banking and specify the necessary information. 3. Click Manage Your Applications. 4. In the Manage Your Apps page, click the application for which you want to set up a free subscription. 5. Click Manage In-App Purchases.
Adobe Publishing Process for iPad Apps ADOBE CONFIDENTIAL Viewer Builder 1.8 Page 30
6. Click View or Generate a Shared Secret. If a Shared Secret section does not appear on the In-App Purchases page, it means you have not filled out the necessary banking information or you have not accepted the terms of agreement. Click Go Back, and then click the Contracts, Tax, and Banking option. 7. Copy your shared secret code. Use the Account Admininistration tool on the DPS Dashboard to specify your shared secret. After you specify the shared secret information, open the Folio Producer Organizer to trigger the shared secret registration. You can also send your shared secret to dmpubsupport@adobe.com. You can use the same shared secret code for multiple apps. 8. Click Create New. 9. In the Create New In App Purchase page, select Free Subscription. 10. Follow the prompts to fill out the rest of the subscription information. For Product ID. We recommend that you use the com.publisher.publication.free format, such as com.adobe.dpstips.free. When you use Viewer Builder to create your subscription app, you select Free and specify the Product ID in the Subscription Details panel. Enabling an app for Newsstand Apple requires you to use iTunes Connect to enable an app for Newsstand. Do this before you submit your distribution viewer app to Apple. 1. Go to http://itunesconnect.apple.com, and sign in. 2. Click Manage Your Applications. 3. In the Manage Your Apps page, click the application in which you want to enable Newsstand. 4. Click Newsstand. 5. Enable Newsstand, and specify a cover image, such as a 1024x768 PNG file, and follow the prompts. 6. For each folio that will appear in your Newsstand app, use the Add Issue feature to add the folio and specify a cover image. For best results, make sure that your cover image includes you app name.
ADOBE CONFIDENTIAL
ADOBE CONFIDENTIAL
4. Open the custom viewer app on your iPad, and test it. Make sure that you can download the free preview issue. Before you can test your retail issues, you need to use iTunes Connect to create a test user and begin the submission process for In App Purchases. While submitting the retail issue using In App Purchase, youll specify the Product ID, which should be identical to the Product ID you specify when publishing the folio. For details, see the next section on submitting apps to the Apple Store. 5. Do any of the following: If the development Viewer needs to be changed, use the Viewer Builder to create a new development app. Delete the previous app, install the new one, and test again. If the development Viewer works as designed, submit your distribution app to the Apple Store. After you submit your distribution app that allows downloads of multiple issues, you need to test the retail issues to make sure that everything is working properly. See Testing Retail Issues in the Sandbox later in this document.
ADOBE CONFIDENTIAL
duration available by submitting it through Apples In App Purchase process before you submit your distribution app. Otherwise, youll need to submit your app again. When you receive the final binary distribution file, you can use the Application Loader to upload the binary file and wait for Apple to approve it. See App Store Submission Tips. 1. On the main iTunes Connect page, click Manage Your Applications.
3. Under New Application, choose your primary language and type the name of your company.
The company name will be associated with all applications submitted from this account.
Adobe Publishing Process for iPad Apps ADOBE CONFIDENTIAL Viewer Builder 1.8 Page 34
4. Under App Information, specify the app name and SKU number, and choose your Bundle ID
Enter information for the Viewer app, not the specific issue. Tip: To learn more about each option, click the question mark icon to options right. 5. Under Rights and Pricing, set the price tier for a single-issue Viewer. For a multi-issue Viewer, a common approach is to make the Viewer free, and then specify a different price tier for each issue when you submit it using In App Purchase.
6. Under Version Information, specify information for the viewer app itself, not the issue content. Youll most likely use 1.0 for Version Number. You may also want to create a website or webpage that customers can go to for information about the app. Specify that URL in the App URL field.
7. Scroll down, and fill out the rest of the fields. You need to include an icon and an iPad
ADOBE CONFIDENTIAL
8. When finished, click Save Changes, and then click Done. You can click View Details to edit the app you created. For example, you can click Manage Localizations to sell your app in other languages.
9. When youre ready to submit the binary distribution app, click View Details in the Ready to Upload Binary. 10. Indicate whether the app is encrypted. Adobe currently does not encrypt viewer apps.
ADOBE CONFIDENTIAL
11. If you have not already downloaded the Application Loader app, click Download App Loader. (If you downloaded XCode, Application Loader was also downloaded. However, make sure that you have the most recent version of the Application Loader installed.)
12. Start Application Loader, and follow the prompts to upload the binary distribution (.zip) app that Adobe provided you.
If you get an error message such as the dwarfdump binary must exist or com.apple. transporter.util.StreamUtil when you upload the .zip file, make sure that you have the most recent version of the Application Loader. Apple will notify you when your app is accepted or rejected. You can use iTunes Connect to track the status. For details, see the Developer Guide. If you notice an error in your app after you have submitted it, you can submit a new binary while your app is still pending. Go the Manage Applications section of iTunes Connect, click View Detail, click Binary Details, and then click Reject Binary. Then submit a new version of the app. If your app is already approved, you can submit an update. Testing retail issues in the sandbox While testing the app, you can create a test user that lets you download the folio using the development app without actually paying for the issue. This sandbox testing process is explained in more detail in the Managing Your In App Purchases section of the iTunes Connect Developer Guide. 1. Make sure that you have already submitted your distribution app (the custom viewer) to the Apple Store. 2. In the Folio Producer Organizer or Digital Content Bundler, publish folios with statuses set to Retail and Public and the appropriate Product ID. This product ID must be identical to the product ID you specify when submitting the
ADOBE CONFIDENTIAL
In App Purchase. We recommend that you use the com.yourcompany.yourmagazine. yourissue format for your Product IDthe App ID name followed by the issue name. In our example, we use com.adobe.dpstips.october. 3. Using iTunes Connect, make sure you have started the submission process for both the distribution app (the custom Viewer) and the In App Purchase (the retail issue), as described earlier in this guide. 4. Using iTunes Connect, create a test user. A test user lets you test the process of purchasing an issue without actually having to purchase the issue. To create a test user, go to the main page of iTunes Connect, and click Manage Users. Click Test User. Click New User, and then specify information. Use a valid email address that you can use to verify. Remember the email address and password. Youll need this information to purchase your issue.
5. On your iPad, sign out of your account. Tap Settings, tap Store, tap your Apple ID, and tap Sign Out. Sign out to make sure that you dont actually use your real account to purchase the issue. Do not sign in using your test userremain signed out. Otherwise, your test user will treated like a normal user, and youll be prompted for your credit card information. 6. Open the development app on your iPad. (See Testing the Development App earlier in this guide.) 7. When notifiied of a new issue, follow the prompts, and sign in using your test user account information. Purchase and download the folio or subscription. If youre prompted for credit card information, exit Viewer, and sign out of your account. Start Viewer again, do not sign in, and then download the issue. 8. Do any of the following: If you need to edit the text that displays during the notification process, use iTunes Connect to edit the item. If the download works as designed, use iTunes Connect to approve the issue. For
ADOBE CONFIDENTIAL
After Apple approves your first retail issue, consider submitting additional issues in advance so that you can avoid unnecessary delays. When youre done testing, sign back in on your iPad with your Apple ID.
click Approve. At that point, you are prompted to select Sumbit With Binary or Submit Now. Choosing Submit With Binary allows the retail issue and the viewer app to go live at the same time, and it allows Apple to view the retail issue inside the customer Viewer app. Issues not showing up in multi-issue viewer If your free issue is not showing up in your Developer Viewer or if it has a gray screen, do the following: Make sure that the published folio statuses are set to Free and Public. Make sure that you included the iPads UDID in the developer mobileprovision file. Only provisioned iPads can view developer viewer content. If your paid issue is not showing up in your Developer Viewer, do the following: Make sure the Product ID in the Bundler matches the Product ID exactly in the In App Purchase section of iTunes Connect. Make sure the published folio statuses of the paid issue are set to Retail and Public. In the In App Purchase section of iTunes Connect, make sure that youve selected Cleared for Sale so you can test the app. Make sure that all your tax and banking information has been entered and approved by Apple no in-app purchases will show up if it hasnt, and there is no warning message indicating that this needs to be done. For subscription viewer apps, make sure that you specify the shared secret information using the Account Administrator tool and then you sign in to the Folio Builder Organizer afterwards to register the shared secret. Blank password not accepted When prompted for a password while creating your .p12 certificates, do not use a blank password. Type a real password. Cannot install item. Please restart the app and download your purchase again One cause for this error is an additional space at the end of a folder name. Check the folder name in your folio folder, and remove any extra spaces. Then publish again. Interactive objects dont work with new authoring tools or download error message You may receive the following iPad download error message: The issue youre trying to download requires a new version of the viewer. Please close the app and download the new version. Do not create folios with authoring tools that are more recent than the viewer. Publish folios with the same versions of the tools and Viewer. New authoring features are introduced with each release that are not compatible with previous versions of the viewer. In a few instances, a more recent viewer changes the behavior of older authoring tools. The safest approach at this time is to use the tools and viewer from the same release drop. If youre using a new set of tools to bundle old content, test the folio files thoroughly. Invalid certificate or Invalid ZIP format If you upload an .ipa file to Apple from a computer running Snow Leopard 10.5 and the certificates have been created on a computer running 10.6, one of these messages may appear. For best results, upload the .ipa file from the same OS X 10.6 computer on which the certificates were created.
ADOBE CONFIDENTIAL
Error: Identity iphone developer doesnt match any identity in any profile This error occurs when files are generated under different profile names. For best results, make sure that the same person uses the same profile to create the certificates on the same computer. Error: Missing Push Notification Entitlements Create new mobileprovision files and try uploading again. ________________________________ If you have suggestions for improving this Companion Guide, please send your feedback to Bob Bringhurst (bbringhu@adobe.com).
ADOBE CONFIDENTIAL