Prerequisite knowledge
Basic knowledge of Digital Publishing Suite and Apple Developer Account (iTunes Connect)
 
User level: Intermediate, Advanced
 
Required products
 
Additional required other products
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.
This article assumes that you have an existing DPS live app on the Apple App Store. In this article, you will learn how to upgrade your existing DPS live app onto Apple App Store.
 
Note: This guide is intended for publishers who have already created a custom viewer app. If you have not already created a custom viewer app, you should read the Publishing Companion Guide for the iPad instead of this document. The Companion Guide PDF is available for download on the DPS Dashboard. It walks you through the entire process of building custom viewers, including viewers enabled for Newsstand.
 

 
Update your existing DPS app

You will want to update your existing DPS live app for many reasons:
 
  • Enable new features that weren't previously enabled in earlier versions of your App.
  • Provide bug fixes to your existing live app.
  • Provide new features as and when Adobe DPS releases them with each new release of the DPS tool set.
  • Changing app metadata, such as correcting typos, adding or changing screenshots, images, and icons, changing your app's name, changing the privacy policy or support URL, or any other necessary updates.

 
Rebuilding your app from DPS App Builder

Updating your DPS app for the Apple App Store requires that you submit a new binary to Apple for approval, including any changes you want to make. This means you need to rebuild your current existing DPS app from inside of the App Builder. Follow the instructions below to rebuild your and edit changes you want to make:
 
  1. Log into your DPS App builder using the email ID that has the Viewer builder roles and rights assigned for Pro and Enterprise customers. For Single Edition customers, use the same e-mail ID under which you purchased your Single Edition serial number. If you can't find DPS App builder on your machine, you can download and install it from your DPS Dashboard.
  2. Select the app you want to edit from the list.
  3. Click Edit at the top of App Builder (see Figure 1) to open the editor.
Figure 1. Beginning the editing process for your DPS app

Figure 1. Beginning the editing process for your DPS app

 

  1. Here are some examples of what you can do to modify or update your app when rebuilding it from the DPS App Builder.
    1. Change the app's name as it appears on the device; or change the DPS app version—for example, from R24 to R25.
    2. If you are making changes to your app icons and splash screen images, you can now go ahead and relink your app icons to your new icon location on your hard drive.
    3. Enable social sharing, if it wasn't enabled in the previous version of your app. For more details, read the documentation on how to set up Social Sharing.
    4. You can use your existing certificates previously generated and saved to your machine for that same app you are updating; or, if you have created new certificates, relink your app to the new certificate location of on your machine's hard drive. For details on how to generate certificates, read the Publishing Companion Guide for the iPad. The Companion Guide PDF is available for download on the DPS Dashboard.
  2. Complete the rebuild process and finish.
  3. Download the file developer-viewer.ipa and test your app on your test device to make sure everything is functioning as it should be.
If you find your app to be functioning as expected, now download the updated distribution-viewer.zip and save it to your desktop.
 

 
Adding the new version and its metadata in iTunes Connect

Before you can send a new version or an update to Apple for approval, you need to provide metadata information about your updated app .
 
  1. Log into your iTunes Connect Account (Use the same credential as the Apple Developer account you used to generate the certificates for your existing live app.)
  2. Click Manage your Applications.
  3. Click the icon of the app you want to update.
  4. Click Add New Version as shown in Figure 2.
Figure 2. Adding a new version to your app

Figure 2. Adding a new version to your app

 

  1. In the Version Number field, increment your version number by 1 from the version number on the present app live on the App Store; for example, if the present app version live on the App Store is 2.1 or 2.0.1 (whatever convention you may have used), increment by 1 to 2.2 or 2.0.2, respectively (see Figure 3).
Figure 3. Incrementing your app's version number

Figure 3. Incrementing your app's version number

 

  1. Write a description of the new version and save the changes.
    Note: This description is customer-facing and will be displayed in the App Store. The moment your new version is approved, the user will see a notification on their device's App Store of an available update, and the description entered above in "What's new in this version" will be displayed.
    Here are some example messages for what you might want to write in the description field:
     
    • Fixed a bug where the viewer app crashes when the device is not connected to the Internet.
    • Added new Facebook social sharing feature.
    • Background downloading of folios is now possible with the new version.
    • The app name has been changed from "ABC Magazine 2013" to "ABC Magazine."
  2. Notice now that all the metadata fields become editable; see Figure 4. You can then edit any previous app metadata which was not editable before you added a new version. For example, changing your app's name is only possible by adding a new version of your app.
Figure 4. Edit buttons are now active.

Figure 4. Edit buttons are now active.

 

  1. When you have everything in place, click Ready to upload binary on the top-right corner or the bottom-right corner of the screen and choose the appropriate option as shown in Figure 5.
Figure 5. Options available on app upload

Figure 5. Options available on app upload

 

  1. Choose whether you want to control when to release the app for sale or allow Apple to automatically push it for sale the moment it's approved (see Figure 6).
Figure 6. Selecting when to release your app for sale

Figure 6. Selecting when to release your app for sale

 

 
Sending the Binary to Apple

Sending the updated binary file requires an application called Application Loader, which may have already been installed on your machine.
 
  1. Launch Application Loader from your Utilities folder.
  2. Log in with the same Apple Developer account used to update the app in iTunes Connect and click Deliver Your App (see Figure 7).
Figure 7. Click here and insert your figure caption.

Figure 7. Click here and insert your figure caption.

 

  1. Browse and choose the distribution-viewer.zip file downloaded to your desktop (hard drive) on step 6 in the section "Rebuilding your app from DPS App Builder" and click Send.
  2. Application Loader verifies your binary file and sends it if it's found valid; if invalid, it will return with a relevant error message
Note: If you encountered an error message "Error - The binary you are sending contains a lower marketing version value than the existing live binary" while sending the binary, please log into your DPS dashboard and Contact Support to resolve this issue.
 
You will receive an email confirmation from Apple when your app is approved; otherwise, you will receive a rejection email with a reason why and a Resolution Center to walk you through making the required changes.
 

 
Where to go from here

Now that you've submitted your application, you might want to request an expedited App review by filling the request form to Apple. For additional information about this process, see: