iOS Installation Steps
How to install a Pgyer-distributed beta build on iOS via Safari, including enabling Developer Mode and trusting enterprise certificates.
This page walks you through installing an iOS app distributed via Pgyer on an iPhone or iPad, including switching from an in-app browser to Safari, enabling Developer Mode, and trusting an enterprise certificate.
Get the Install Link
The developer typically shares the install entry point in one of these ways:
- A link in an email;
- A link in an SMS or instant-messaging app;
- A QR code you can scan with the camera.
Open the Link in Safari
Always open the install link or scan the QR code in Safari. Other browsers may not be able to trigger the installation flow.
If you opened the install page in the in-app browser of WeChat, DingTalk, Alipay, or similar apps, tap the More (three-dot) icon in the top right and choose Open in Safari. Otherwise installation cannot complete.
Tap "Install"
Safari shows the install page with the app details. Tap Install; iOS displays a confirmation dialog, and tapping Install again starts the download.
Return to the Home Screen to Monitor Progress
Go back to the Home Screen and you will see the app icon being downloaded. Once the download finishes, tap the icon to launch the app.
Enable Developer Mode
On iOS 16 and above, you need to enable Developer Mode the first time you install an Ad-Hoc build. You only need to do this once:
- Open the Settings app;
- Go to Privacy & Security;
- Scroll down and tap Developer Mode;
- Toggle it on, enter your device passcode when prompted, and restart the device.
Trust the Enterprise Certificate
For enterprise in-house apps, you need to trust the certificate manually. You only need to do this once:
- Open the Settings app;
- Go to General;
- Tap Device Management or VPN & Device Management (the label varies between iOS versions);
- Under Enterprise App, select the certificate, tap Trust, and confirm in the dialog.
Common Issues
- Cannot install the app: Make sure the device is online and the install link is correct; restart the device and try again if needed.
- The app crashes on launch: Usually this means the enterprise certificate has not been trusted. Follow the steps above.
For more failure scenarios, see Troubleshooting iOS installation failures.
How to Install an App
The overall flow for installing a beta build distributed through Pgyer, plus an index of platform-specific steps and common installation issues.
Troubleshooting iOS Installation Failures
Common causes of iOS installation failures, including signing issues, untrusted enterprise certificates, and Developer Mode being disabled, with fixes for each.