Having trouble installing or launching your iOS app on a Perfecto cloud device? That's bad news. The good news is that this usually happens only due to a handful of reasons, all of which are pretty easy to fix.
What to do if your app won't install
The device log is typically key in understanding why your app won't install. You should get the device log immediately after your failed installation attempt.
Look for the following keywords in the device log to help you identify common root causes for installation failure:
|Keyword||Meaning||What to do|
|VersionTooLow||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". |
Select another device or contact the app developer to rebuild a version of the app supporting your test device.
|UIDeviceFamily||You 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 signed||The file is not signed properly or has the wrong provisioning.||See iOS Troubleshooting - Install App Fails.|
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-premises 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 application||Failed to allow additional actions.||Contact 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 start-up 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.
|Keyword||Meaning||What 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 above, 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.|