Troubleshooting iOS Installation Failures

When installing a Pgyer-distributed app on iOS, you may see errors such as Unable to Install, Cannot Verify App, or Installation Failed. This page lists the common causes and fixes.

"Unable to Install", "Cannot Verify", or a Dimmed Icon

This is usually caused by an invalid signature. Common reasons include:

• Certificate expired: The signing certificate is past its expiry date.
• Mismatched provisioning profile: The provisioning profile does not match the bundle identifier or the certificate.
• UDID not registered: For Ad-Hoc distribution, the device's UDID was not added to the provisioning profile.

Try the following first:

1. Check whether the same app is already installed; if so, uninstall it and retry.
2. If that does not help, contact the developer who invited you to resolve the signing issue.

Untrusted Enterprise Developer

For enterprise-distributed apps, you need to trust the certificate after the first install:

1. Go back to the Home Screen and open Settings > General > VPN & Device Management;
2. Tap the relevant profile and choose Trust.

Developer Mode Not Enabled

If the device requests Developer Mode, follow the steps below. Development-signed apps and workflows such as Xcode debugging require it on iOS 16 / iPadOS 16 and later; an Ad Hoc / Beta label alone does not establish a universal pre-install requirement.

1. Open Settings → Privacy & Security → Developer Mode.
2. Turn it on and restart the device when prompted.
3. After restarting, confirm that you want to enable it and enter the device passcode when prompted.

Enabling it does not guarantee installation: signing, device registration, provisioning profiles, and OS compatibility still matter. If the setting is missing, check Apple's device-pairing guidance. See Developer Mode troubleshooting for the workflow conditions and sources.

Incompatible iOS Version

Confirm the minimum iOS version the app targets. If your device runs an older version, upgrade iOS first.

Unstable Network

Installation downloads the package on demand, so connect to a stable Wi-Fi network to avoid incomplete downloads.

Insufficient Storage

Make sure the device has enough free space for the app. Clear files or uninstall unused apps if needed.

Conflict with an Older Version

If an older version is already installed, signing or bundle-identifier conflicts may block the new build. Uninstall the old version and retry.

Device Compatibility

Some apps rely on frameworks or capabilities available only on newer devices. Confirm the device is within the app's supported range.