Unable to install a developer .ipa file on a device

When testing a developer .ipa file, it fails to install to a device, or appears to install but is darkened and cannot be launched.

Ensure the app is built with a developer mobile provisioning file that contains the UDID of the device you are installing to.

Determine the UDID for the device you are installing to:

  1. Connect the device to the computer you synch it with.
  2. Launch iTunes.
  3. Select the device and view the Summary section.
  4. Look for, and click on the Serial Number (this will cause the UDID to display)
  5. Choose Edit > Copy UDID.
Look for the UDID in the developer app's mobile provisioning:
  1. Make a copy of your developer ipa file.
  2. Change the extension to .zip and decompress it.
  3. In the resulting folder, open the payload folder and locate the viewer.app file.
  4. Control-click on the .app file and choose Show Package Contents.
  5. Locate the embedded.mobileprovisioning file and open it in a text editor.
  6. Search for the UDID string located earlier.
If the UDID is not found, follow the instructions in the Adobe iOS Publishing Companion Guide Professional & Enterprise Edition or Adobe iOS Publishing Guide for DPS 2015 to properly add the UDID to the developer mobileprovisioning file and rebuild your app.

Other possible causes/solutions

The developer .p12 file used to sign the .ipa is incorrect or contains only one certificate entry. Resolve this by recreating the certificate and ensuring only it is selected when exporting to .p12 from the Keychain Access application.

One or more web asset uses special characters, symbols, or spaces. Rename the files, fix any links as needed, and rebuild the app.

A .zip package of web assets was created from a folder. Repackage .zip files such that the source doesn't contain any parent folder, for example:

Repackage .zip files such that the source doesn't contain any parent folder

Additional information

Changing the .ipa extension to .zip allows you to open it and view the Contents of the viewer.app file. Inside, you can find the file "embedded.mobileprovision" which can be opened in a text editor and searched for the device UDID.

Because filenames are used in URIs, it's best to avoid any character defined as "reserved" or "unsafe."

The DPS App Builder expects .zip files to contain root level resources. An additional container folder causes it to miss the root level .html file.