by Lohrii Alo
Table of contents
18 March 2013
User level: Intermediate, Advanced
|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.|
- 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.
- 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.
- Select the app you want to edit from the list.
- 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
- Here are some examples of what you can do to modify or update your app when rebuilding it from the DPS App Builder.
- Change the app's name as it appears on the device; or change the DPS app version—for example, from R24 to R25.
- 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.
- 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.
- 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.
- Complete the rebuild process and finish.
- Download the file developer-viewer.ipa and test your app on your test device to make sure everything is functioning as it should be.
- 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.)
- Click Manage your Applications.
- Click the icon of the app you want to update.
- Click Add New Version as shown in Figure 2.
Figure 2. Adding a new version to your app
- 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
- 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."
- 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.
- 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
- 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
- Launch Application Loader from your Utilities folder.
- 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.
- 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.
- Application Loader verifies your binary file and sends it if it's found valid; if invalid, it will return with a relevant error message