This page provides troubleshooting help and answers to frequently asked questions about distributing and testing apps with App Distribution.
Installing and testing apps
The following tips help testers troubleshoot issues that involve installing test apps and accessing them on a device.
Untrusted Enterprise Developer error when trying to run test app
The Untrusted Enterprise Developer error appears if you did not trust the developer certificate on the test device before opening the app. In the Settings app > Profiles & Device Management screen, select the app's developer name and trust it.
Waiting for developer prevents installing test app
If you're installing an Ad Hoc distribution, the Waiting for developer button appears when the developer hasn't yet configured their app to run on your test device. To make their app available to you, the developer must complete the following steps:
Add the test device's UDID in the Apple Developer portal (the UDID is emailed to the developer when you register the device to Firebase).
Include the device in the app's provisioning profile.
Build the app using the updated provisioning profile.
Are there limits for adding testers to my app?
Firebase App Distribution has the following tester limits:
Add a maximum of 500 testers to a Firebase project
Add a maximum of 200 testers to an App Distribution group
Add a maximum of 200 testers per distribution
To add more testers, request a free limit increase.
What is the Firebase profile?
The Firebase profile is a configuration profile that allows App Distribution to:
Register the test device by collecting the device's unique device ID (UDID). If you're testing an Ad Hoc distribution, Firebase sends the app developer an email that includes the test device's UDID, along with instructions on how to include the device in the app's provisioning profile so that the build can be tested on your device.
Install a Firebase App Distribution web clip to your device's home screen. The web clip allows you to install and access all your test apps in one place. New builds you're invited to test are automatically added to the web clip.
For help on installing configuration profiles on your iOS device, refer to Apple's documentation.
How can I access test apps I installed on my device?
If you're a tester, you can access all of your test apps with the Firebase App Distribution web clip, which is automatically added to your test device's home screen when you install the Firebase profile. If you're testing an Ad Hoc distribution, you must first install the profile before you can test the app.
If you're testing an Enterprise distribution, you can manually install the profile:
If you haven't already, sign in to Google and accept the invitation.
Under Test apps, select the app you want to test.
In the top right of the app's page, tap mobile_screen_share.
Follow the instructions displayed to install the Firebase profile.