Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

Black screen appears on iOS when app is first installed



The user upgraded from 7.1.8 to 7.2.2. They have installed their Mobile application on iOS devices and while launching the application they are seeing a black screen which appears for 5-6 seconds before the login screen shows up. They reported this issue to be specific to iOS devices.

Error Messages

Not Applicable

Steps to Reproduce

  1. Scan the QR code of the mobile application using the Pega Mobile Express application.
  2. Proceed to download and install the mobile application on the iOS device.
  3. Launch the installed application on an iOS device like iPhone or iPad.
  4. The screen goes blank for 5-6 seconds after which the branding icon is displayed on the whole screen.

Root Cause

A defect in Pegasystems’ code or rules is identified as root cause of the issue. If we create custom application install splash screen without pega logo element then animateOnLoadScreen function fails which results in splash screen never being hidden.


Follow the below steps:
  1. Apply HFix-34176.
  2. Delete the Pega Temp Directory, extract marker file and restart the application server.
  3. Delete the previously installed mobile application from the iOS device.
  4. Ensure that all the branding assets used for building the mobile application are in place.
  5. Rebuild the mobile application after enabling splash screen (set in present in file).
  6. Install the updated mobile application on the iOS device.

Published May 16, 2017 - Updated October 8, 2020

Was this useful?

0% found this useful

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us