Page tree
Skip to end of metadata
Go to start of metadata

Last updated: Jun 25, 2020 14:01


If you have trouble installing or launching your iOS app on a Perfecto cloud device, the good news is that this is usually related to a handful of reasons that are all easy to fix.


What to do if your app won't install

If your app doesn't install, the device log is typically key in understanding why. You should get the device log immediately after your failed installation attempt.

For information on how to retrieve the device log, see:

Look for the following keywords in the device log to help you identify common root causes for installation failure.

KeywordMeaningWhat to do

The minimum OS version defined for the application is higher than that of the device on which you are trying to install the app. For example, an iOS 9 application may not run on iOS 7. The iOS application will not install and throws an error that the "OS Version is Too Low".

Installation failed: Error Domain=LaunchServicesError Code=0 "The operation couldn't be completed. (LaunchServicesError error 0.)" UserInfo=0x17e44350 {Error=DeviceOSVersionTooLow}

Select another device or contact the app developer to rebuild a version of the app that supports your test device.

UIDeviceFamilyYou are trying to install an app on an unsupported device type. For example, you are trying to install an iPad-only app on an iPhone, or an Apple TV app on a phone.Select an appropriate test device or contact the app developer if you believe the test device should be supported by the build.
File not signedThe file is not signed properly or has the wrong provisioning.See App installation fails | Troubleshooting.

Profile not valid: <device UDID>

You are trying to install an app that is signed with a development certificate on a device that has not been provisioned for testing the app.Unless you are testing on an on-premise cloud, contact the app developer to obtain an app build signed with a distribution certificate.
Wakeup sequence failed

This device does not support XCTest.

Support is in progress. If possible, use another device.
Cannot instrument applicationFailed to allow additional actions.Contact Perfecto Support.

What to do if your app won't launch

If you try to launch an app and get the error "app developer not trusted on this device," it means that you need to allow this developer to run applications (signed by him or her) on the device. To do this, go to Settings > Profiles tab, tap the profile, and click Trust.

If you get the error "app crashed on startup," it means that the app did launch but crashed during its startup phase.

As with install errors, most of the hints regarding launch failures come from the device log that should be retrieved immediately after the launch failure. The keywords below will help you understand how you may fix the issue.

KeywordMeaningWhat to do

Unable to launch <your app bundle> because it has an invalid code signature, inadequate entitlements or its profile has not been explicitly trusted by the user.

On iOS9 and later, you have to explicitly trust the app developer for apps signed with enterprise distribution certificates.

See this article for details on how to trust an app developer.

Formulating crash report for <your app bundle> 
or app crashed on startup
Your app crashed on startup.Contact the app developer to try to launch the app on a local device. If the problem does not reproduce, Contact Support to retrieve the crash report and provide it to the app developer.