Ta strona zawiera pomoc w rozwiązywaniu problemów i odpowiedzi na często zadawane pytania dotyczące dystrybucji i testowania aplikacji za pomocą usługi App Distribution.
Dystrybucja aplikacji
Skorzystaj z poniższych wskazówek, aby rozwiązać problemy, które mogą wystąpić podczas dystrybucji aplikacji do testerów.
Podczas przesyłania aplikacji może wystąpić ten błąd:
„Nie mogliśmy znaleźć kontaktowego adresu e-mail dla aplikacji <app-id> . Odwiedź sekcję Dystrybucja aplikacji w konsoli Firebase, aby ją skonfigurować”.
Ustaw kontaktowy adres e-mail w konsoli Firebase, jeśli jest dostępny. Jeśli problem będzie się powtarzał, skontaktuj się z pomocą techniczną Firebase .
Jeśli podczas obsługi administracyjnej wielokrotnie napotykasz błędy 400, 409 lub 500, skontaktuj się z pomocą techniczną Firebase . Podaj numer projektu Firebase i identyfikator aplikacji.
Poniżej znajduje się przykład odpowiedzi sieciowej przeglądarki:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
Aby rozwiązać ten problem, wykonaj następujące kroki:
Sprawdź rozmiar IPA. Maksymalny limit rozmiaru pliku dla wszystkich plików binarnych to 2048 MiB, czyli nieco ponad 2 GB.
Jeśli rozmiar IPA mieści się w limicie rozmiaru pliku i można go odtworzyć, wykonaj następujące czynności:
Sprawdź plik
Info.plisti potwierdź, czyCFBundleDisplayNamezawiera ograniczniki<array>.Usuń ograniczniki
<array>i odbuduj aplikację. Przesyłanie powinno się powieść.Jeśli nadal występują problemy, skontaktuj się z pomocą techniczną Firebase .
Jeśli rozmiar IPA przekracza limit rozmiaru pliku, wprowadź niezbędne zmiany, aby zmniejszyć rozmiar pliku.
Jeśli zmniejszenie rozmiaru pliku IPA nie rozwiąże problemu, skontaktuj się z pomocą techniczną Firebase i zapytaj o możliwość korzystania z Testflight .
Instalowanie i testowanie aplikacji
Skorzystaj z poniższych wskazówek, aby rozwiązać problemy, które testerzy mogą napotkać podczas instalowania i testowania aplikacji.
Gdy użytkownik tworzy konto Google, automatycznie otrzymuje adres Gmail.
Jeśli tester nie ma adresu Google Workspace ani adresu Gmail albo woli użyć innego adresu e-mail do zalogowania się, poproś testera o powiązanie z kontem adresu e-mail innego niż Gmail i zalogowanie się przy użyciu tego adresu e-mail.
Wybierając alternatywny adres e-mail, tester musi przestrzegać następujących wskazówek:
- Nie używaj adresu Gmail.
- Nie używaj adresu e-mail, który jest już połączony z innym kontem Google.
- Pamiętaj, aby użyć hasła do konta Google podczas logowania za pomocą tego adresu e-mail.
Aby uzyskać więcej informacji, zobacz Logowanie się na konto Google przy użyciu innego adresu e-mail .
Jeśli tester zaakceptował zaproszenie e-mail z innym adresem e-mail niż ten, na który zostało wysłane zaproszenie, tester może nie widzieć odpowiednich aplikacji lub kompilacji.
Adres e-mail, na który programista wysyła zaproszenia i które dodaje do nowych kompilacji (e-mail A), może różnić się od adresu e-mail, którego używa tester do zaakceptowania zaproszenia (e-mail B). To tworzy link za kulisami. Ilekroć e-mail A jest dodawany do nowych kompilacji, w rzeczywistości dostęp uzyskuje e-mail B.
Jeśli tester zaakceptował zaproszenie e-mail z innym adresem e-mail, wykonaj następujące czynności, aby rozwiązać problem:
Usuń testera z sekcji Wyświetl wszystkich testerów na karcie Testerzy i grupy na stronie Dystrybucja aplikacji w konsoli Firebase. Istniejące zaproszenia zostaną usunięte.
Ponownie zaproś testera do przetestowania Twojej aplikacji. Tester powinien otrzymać wiadomość e-mail z zaproszeniem.
Upewnij się, że tester akceptuje zaproszenie z tym samym adresem e-mail.
Testerzy mogą nie otrzymywać powiadomień e-mail, jeśli wystąpi jedna z poniższych sytuacji:
Powiadomienia e-mail są wysyłane do folderów ze spamem.
Filtry e-maili są ustawione.
Zaproszenie zostało wysłane na jedno konto e-mail, ale tester zaakceptował je za pomocą innego konta e-mail. Tester otrzymuje wiadomości e-mail z nowymi wersjami dla konta e-mail, na które pierwotnie wysłano zaproszenie.
Tester został wcześniej zaproszony, ale nie przyjął pierwszego zaproszenia. Jeśli tester zostanie dodany do kolejnych wersji, usługa App Distribution nie będzie automatycznie wysyłać powiadomień o wydaniach do tego testera, ponieważ tester nie zaakceptował początkowego zaproszenia.
Rozwiązanie 1
Poproś testera o sprawdzenie folderu ze spamem i wszelkich filtrów e-mail ustawionych w jego usłudze e-mail.
Jeśli tester anulował subskrypcję e-maili, poproś testera o wykonanie następujących czynności:
- Znajdź wiadomość e-mail, którą tester otrzymał wcześniej z aplikacji.
- Kliknij Zarządzaj ustawieniami poczty e-mail u dołu i kliknij Zezwalaj na ponowną subskrypcję e-maili .
Rozwiązanie 2
Usuń testera z sekcji Wyświetl wszystkich testerów na karcie Testerzy i grupy na stronie Dystrybucja aplikacji w konsoli Firebase. Ta czynność usuwa istniejące zaproszenia.
Ponownie zaproś testera do przetestowania Twojej aplikacji. Tester powinien otrzymać wiadomość e-mail z zaproszeniem. Upewnij się, że tester akceptuje zaproszenie z tym samym adresem e-mail, na który zostało wysłane zaproszenie.
Błąd Untrusted Enterprise Developer pojawia się, jeśli nie ufałeś certyfikatowi programisty na urządzeniu testowym przed otwarciem aplikacji. Na ekranie aplikacji Ustawienia > Profile i zarządzanie urządzeniami wybierz nazwę programisty aplikacji i zaufaj jej.
Błąd Wymagany tryb programisty pojawia się, gdy próbujesz uruchomić aprowizowaną ad hoc aplikację na iOS w systemie iOS 16 lub nowszym bez uprzedniego włączenia trybu programisty.
Aby włączyć tryb programisty i rozwiązać ten błąd, wykonaj następujące kroki:
- Na iPhonie otwórz aplikację Ustawienia, a następnie stuknij Prywatność i bezpieczeństwo .
- Przewiń w dół do Zabezpieczenia i dotknij Tryb programisty .
- Stuknij suwak Tryb programisty .
- Stuknij Uruchom ponownie .
- Po ponownym uruchomieniu urządzenia odblokuj urządzenie. Włącz tryb programisty? pojawi się okno dialogowe.
- Stuknij Włącz . Możesz teraz uruchomić aplikację i rozpocząć testowanie.
Jeśli instalujesz dystrybucję Ad Hoc, ten komunikat pojawia się, gdy programista nie skonfigurował jeszcze swojej aplikacji do działania na urządzeniu testowym. Aby udostępnić Ci aplikację, programista musi wykonać instrukcje opisane w artykule Rejestrowanie dodatkowych urządzeń .
Jeśli Twoje konto Google nie ma dostępu do aplikacji testowej, którą wcześniej zainstalowałeś (lub zaakceptowałeś zaproszenie), prawdopodobnie zalogowałeś się na niewłaściwe konto Google. Aplikacje, do których masz dostęp, są powiązane z kontem Google, którego użyłeś, gdy po raz pierwszy zaakceptowałeś zaproszenie do przetestowania aplikacji. Spróbuj ponownie, logując się na konto Google użyte wcześniej do zaakceptowania zaproszenia.
Gdy napotkasz błąd 403, oznacza to, że konto, którego używasz, nie ma uprawnień do instalowania i testowania aplikacji. Dostęp jest określany przez administratora domeny Twojego konta w Google Workspace.
Jeśli uważasz, że powinieneś mieć uprawnienia do instalowania i testowania aplikacji, poproś administratora konta Google Workspace o zmianę ustawień konta. Administrator powinien postępować zgodnie z instrukcjami w artykule Zarządzanie dostępem do usług, które nie są kontrolowane indywidualnie .
Jeśli masz wiele kont, spróbuj zalogować się przy użyciu innego konta, które nie ma ograniczeń dotyczących instalowania i testowania aplikacji.
Włączanie alertów w aplikacji za pomocą pakietu App Distribution iOS SDK
Skorzystaj z poniższych wskazówek, aby rozwiązywać problemy związane z włączaniem alertów o nowych kompilacjach w aplikacji przy użyciu zestawu App Distribution iOS SDK.
Jeśli masz już skonfigurowany pakiet App Distribution iOS SDK w swojej aplikacji, a Twoi testerzy nie otrzymują alertów w aplikacji, sprawdź, czy Twoja aplikacja pobiera nowe wersje:
Włącz tryb debugowania w swojej aplikacji. Aby dowiedzieć się, jak to zrobić, zapoznaj się z dokumentacją Google Analytics .
Uruchom aplikację w symulatorze i wyszukaj ciąg „[Firebase/AppDistribution]”.
Sprawdź, czy tester ma dostęp do nowej wersji:
Jeśli zostanie zwrócony prawidłowy obiekt wydania, prawdopodobnie wystąpił problem w cyklu życia kontrolera widoku, w którym okno dialogowe alertu jest ładowane przed wyświetleniem widoku.
Jeśli nie zostanie zwrócona żadna wersja, tester może nie być jeszcze powiązany z nową wersją. Na pulpicie nawigacyjnym Dystrybucja aplikacji w konsoli Firebase upewnij się, że tester jest uwzględniony w Twojej dystrybucji kompilacji i ma stan Zaakceptowany .
Jeśli tester nadal nie otrzymuje aktualizacji, poproś go o wykonanie poniższych wskazówek, aby upewnić się, że zaakceptował zaproszenie do przetestowania Twojej aplikacji i prawidłowo skonfigurował swoje urządzenie testowe:
Na urządzeniu testowym zaloguj się do klipu internetowego Firebase App Distribution. Pamiętaj, aby wybrać konto Google użyte po raz pierwszy, kiedy zaakceptowałeś zaproszenie do przetestowania aplikacji.
Upewnij się, że w klipie internetowym jest dostępna nowa wersja aplikacji.
Domyślnie Twoi testerzy muszą tylko raz zalogować się na swoje konto Google, aby włączyć powiadomienia o nowych kompilacjach i zainstalować nowe kompilacje. Jeśli testerzy są proszeni o ponowne zalogowanie się po zamknięciu i ponownym otwarciu aplikacji, postępuj zgodnie z tymi wskazówkami, aby upewnić się, że konfiguracja dystrybucji aplikacji jest prawidłowo skonfigurowana:
Sprawdź, czy masz włączony interfejs Firebase App Testers API. Aby uzyskać więcej informacji, zobacz Włączanie interfejsu API testera dystrybucji aplikacji .
W obszarze Kluczowe ograniczenia upewnij się, że interfejs Firebase App Testers API znajduje się na liście dozwolonych interfejsów API.
Jeśli zazwyczaj usuwasz UserDefaults podczas wylogowywania się, być może czyścisz stan swojego testera. Dystrybucja aplikacji przechowuje flagę wskazującą, czy tester zalogował się już do aplikacji. Aby uzyskać więcej informacji, zobacz repozytorium GitHub .
Często Zadawane Pytania
Dystrybucja aplikacji Firebase ma następujące limity testerów:
Dodaj maksymalnie 500 testerów do projektu Firebase
Dodaj maksymalnie 200 testerów do grupy dystrybucji aplikacji
Aby dodać więcej testerów, poproś o bezpłatne zwiększenie limitu .
Testerzy mają 30 dni na zaakceptowanie zaproszenia do przetestowania aplikacji przed jego wygaśnięciem. Gdy zaproszenie wygaśnie za 5 dni, w konsoli Firebase obok testera pojawi się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie za pomocą menu rozwijanego w wierszu testera.
Zobacz Rejestrowanie dodatkowych urządzeń .
Wersje aplikacji są usuwane z usługi Dystrybucja aplikacji, jeśli spełniony jest jeden z następujących warunków:
- Wersja aplikacji jest starsza niż 150 dni.
- Przekraczasz limit 1000 wersji aplikacji, a wersja aplikacji jest starsza niż 1000 najnowszych wersji aplikacji.
Aby uzyskać więcej informacji, zobacz Dystrybucja aplikacji obsługuje maksymalnie 1000 wydań .
Gdy aplikacja osiągnie lub przekroczy 150-dniowy limit wygaśnięcia lub limit 1000 wydań aplikacji, wersja zostanie usunięta z pulpitu nawigacyjnego dystrybucji aplikacji i aplikacji internetowej testera dystrybucji aplikacji. Jeśli tester zainstalował tę wersję, lokalna wersja aplikacji nadal działa.
Aby wersja aplikacji była dłużej dostępna, skorzystaj z jednej z poniższych rekomendacji:
- Zanim wersja aplikacji wygaśnie lub przekroczy limit wersji, pobierz IPA i usuń wersję z pulpitu dystrybucji aplikacji. Następnie ponownie prześlij IPA jako nową kompilację do dystrybucji aplikacji.
- Pobierz wersję i prześlij ją do Cloud Storage w celu długoterminowej archiwizacji.
Wersje aplikacji wygasają po 150 dniach
Gdy prześlesz wersję swojej aplikacji do Firebase, pojawi się ona w panelu dystrybucji aplikacji przez 150 dni, licząc od daty przesłania. Po przesłaniu wersji możesz ją rozesłać do testerów, którzy zainstalują ją z aplikacji internetowej App Distribution tester na swoim urządzeniu testowym.
Gdy upłynie 30 dni od daty wygaśnięcia wersji, na Twojej wersji na stronie Dystrybucja aplikacji w konsoli Firebase oraz w aplikacji internetowej testera dystrybucji aplikacji pojawi się powiadomienie o wygaśnięciu wersji.
Dystrybucja aplikacji obsługuje maksymalnie 1000 wydań
Dystrybucja aplikacji zezwala na maksymalnie 1000 wydań na aplikację. Kiedy Twoja aplikacja osiągnie limit 1000 wydań aplikacji, Dystrybucja aplikacji automatycznie usunie najstarsze wydania przekraczające ten limit.
Jeśli chcesz ręcznie zarządzać wersjami aplikacji, użyj interfejsu API REST dystrybucji aplikacji, aby zbiorczo wyświetlać i usuwać wersje aplikacji.
Jeśli masz pytania, skontaktuj się z pomocą techniczną Firebase .
Profil Firebase to profil konfiguracyjny, który umożliwia Dystrybucję aplikacji:
Zarejestruj urządzenie testowe, zbierając unikalny identyfikator urządzenia (UDID). Jeśli testujesz dystrybucję Ad Hoc, Firebase wysyła programiście aplikacji e-mail zawierający identyfikator UDID urządzenia testowego wraz z instrukcjami, jak uwzględnić urządzenie w profilu udostępniania aplikacji, aby kompilacja mogła zostać przetestowana na Twoim urządzeniu.
Zainstaluj klip internetowy Firebase App Distribution na ekranie głównym swojego urządzenia. Klip internetowy umożliwia instalację i dostęp do wszystkich aplikacji testowych w jednym miejscu. Nowe kompilacje, do których przetestowania Cię zaproszono, są automatycznie dodawane do klipu internetowego.
Aby uzyskać pomoc dotyczącą instalowania profili konfiguracji na urządzeniu z systemem iOS, zapoznaj się z dokumentacją firmy Apple .
Jeśli jesteś testerem, możesz uzyskać dostęp do wszystkich swoich aplikacji testowych za pomocą klipu internetowego Firebase App Distribution , który jest automatycznie dodawany do ekranu głównego urządzenia testowego po zainstalowaniu profilu Firebase. Jeśli testujesz dystrybucję Ad Hoc, musisz najpierw zainstalować profil , zanim będzie można przetestować aplikację.
Jeśli testujesz dystrybucję Enterprise, możesz ręcznie zainstalować profil:
Jeśli jeszcze tego nie zrobiłeś, zaloguj się w Google i zaakceptuj zaproszenie.
W sekcji Aplikacje testowe wybierz aplikację, którą chcesz przetestować.
W prawym górnym rogu strony aplikacji dotknij mobile_screen_share .
Postępuj zgodnie z wyświetlanymi instrukcjami, aby zainstalować profil Firebase.
Aby usunąć konto testera dystrybucji aplikacji i powiązane z nim dane, wykonaj następujące kroki w podanej kolejności:
Odwiedź https://appdistribution.firebase.google.com i zaloguj się na swoje konto Google.
W prawym górnym rogu kliknij ( Zarządzaj kontem )
Usuń konto .
Opcjonalnie: w uprawnieniach swojego konta Google anuluj dostęp Firebase App Distribution. Pamiętaj, że cofnięcie dostępu bez uprzedniego usunięcia konta App Distribution nie powoduje usunięcia konta ani danych testera.
Ta strona zawiera pomoc w rozwiązywaniu problemów i odpowiedzi na często zadawane pytania dotyczące dystrybucji i testowania aplikacji za pomocą usługi App Distribution.
Dystrybucja aplikacji
Skorzystaj z poniższych wskazówek, aby rozwiązać problemy, które mogą wystąpić podczas dystrybucji aplikacji do testerów.
Podczas przesyłania aplikacji może wystąpić ten błąd:
„Nie mogliśmy znaleźć kontaktowego adresu e-mail dla aplikacji <app-id> . Odwiedź sekcję Dystrybucja aplikacji w konsoli Firebase, aby ją skonfigurować”.
Ustaw kontaktowy adres e-mail w konsoli Firebase, jeśli jest dostępny. Jeśli problem będzie się powtarzał, skontaktuj się z pomocą techniczną Firebase .
Jeśli podczas obsługi administracyjnej wielokrotnie napotykasz błędy 400, 409 lub 500, skontaktuj się z pomocą techniczną Firebase . Podaj numer projektu Firebase i identyfikator aplikacji.
Poniżej znajduje się przykład odpowiedzi sieciowej przeglądarki:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
Aby rozwiązać ten problem, wykonaj następujące kroki:
Sprawdź rozmiar IPA. Maksymalny limit rozmiaru pliku dla wszystkich plików binarnych to 2048 MiB, czyli nieco ponad 2 GB.
Jeśli rozmiar IPA mieści się w limicie rozmiaru pliku i można go odtworzyć, wykonaj następujące czynności:
Sprawdź plik
Info.plisti potwierdź, czyCFBundleDisplayNamezawiera ograniczniki<array>.Usuń ograniczniki
<array>i odbuduj aplikację. Przesyłanie powinno się powieść.Jeśli nadal występują problemy, skontaktuj się z pomocą techniczną Firebase .
Jeśli rozmiar IPA przekracza limit rozmiaru pliku, wprowadź niezbędne zmiany, aby zmniejszyć rozmiar pliku.
Jeśli zmniejszenie rozmiaru pliku IPA nie rozwiąże problemu, skontaktuj się z pomocą techniczną Firebase i zapytaj o możliwość korzystania z Testflight .
Instalowanie i testowanie aplikacji
Skorzystaj z poniższych wskazówek, aby rozwiązać problemy, które testerzy mogą napotkać podczas instalowania i testowania aplikacji.
Gdy użytkownik tworzy konto Google, automatycznie otrzymuje adres Gmail.
Jeśli tester nie ma adresu Google Workspace ani adresu Gmail albo woli użyć innego adresu e-mail do zalogowania się, poproś testera o powiązanie z kontem adresu e-mail innego niż Gmail i zalogowanie się przy użyciu tego adresu e-mail.
Wybierając alternatywny adres e-mail, tester musi przestrzegać następujących wskazówek:
- Nie używaj adresu Gmail.
- Nie używaj adresu e-mail, który jest już połączony z innym kontem Google.
- Pamiętaj, aby użyć hasła do konta Google podczas logowania za pomocą tego adresu e-mail.
Aby uzyskać więcej informacji, zobacz Logowanie się na konto Google przy użyciu innego adresu e-mail .
Jeśli tester zaakceptował zaproszenie e-mail z innym adresem e-mail niż ten, na który zostało wysłane zaproszenie, tester może nie widzieć odpowiednich aplikacji lub kompilacji.
Adres e-mail, na który programista wysyła zaproszenia i które dodaje do nowych kompilacji (e-mail A), może różnić się od adresu e-mail, którego używa tester do zaakceptowania zaproszenia (e-mail B). To tworzy link za kulisami. Za każdym razem, gdy e-mail A jest dodawany do nowych kompilacji, w rzeczywistości dostęp uzyskuje e-mail B.
Jeśli tester zaakceptował zaproszenie e-mail z innym adresem e-mail, wykonaj następujące czynności, aby rozwiązać problem:
Usuń testera z sekcji Wyświetl wszystkich testerów na karcie Testerzy i grupy na stronie Dystrybucja aplikacji w konsoli Firebase. Istniejące zaproszenia zostaną usunięte.
Ponownie zaproś testera do przetestowania Twojej aplikacji. Tester powinien otrzymać wiadomość e-mail z zaproszeniem.
Upewnij się, że tester akceptuje zaproszenie z tym samym adresem e-mail.
Testerzy mogą nie otrzymywać powiadomień e-mail, jeśli wystąpi jedna z poniższych sytuacji:
Powiadomienia e-mail są wysyłane do folderów ze spamem.
Filtry e-maili są ustawione.
Zaproszenie zostało wysłane na jedno konto e-mail, ale tester zaakceptował je za pomocą innego konta e-mail. The tester receives new release emails for the email account to which the invitation was originally sent.
The tester was previously invited but did not accept the initial invitation. If the tester is added to subsequent releases, App Distribution won't automatically send release notifications to that tester because the tester didn't accept the initial invitation.
Solution 1
Ask the tester to check their spam folder and any email filters they set in their email service.
If the tester unsubscribed from the emails, ask the tester to do the following:
- Find an email that the tester previously received from the app.
- Click Manage email settings at the bottom and click Allow emails to resubscribe.
Solution 2
Delete the tester from the View all testers section of the Testers & Groups tab in the App Distribution page in the Firebase console. This action removes existing invitations.
Re-invite the tester to test your app. The tester should receive an invitation email. Make sure that the tester accepts the invitation with the same email address that the invitation was sent to.
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.
The Developer Mode Required error appears when you try to launch an ad hoc-provisioned iOS app on iOS 16 or later without first enabling Developer Mode.
To enable Developer Mode and resolve this error, follow these steps:
- On your iPhone, open the Settings app and then tap Privacy & Security .
- Scroll down to Security and tap Developer Mode .
- Tap the Developer Mode slider.
- Tap Restart .
- After the device restarts, unlock the device. The Turn on Developer Mode? dialog appears.
- Tap Turn On . You can now launch your app and start testing.
If you're installing an Ad Hoc distribution, this message appears when the developer hasn't yet configured their app to run on your test device. To make the app available to you, the developer must complete the instructions in Register additional devices .
If your Google account does not have access to a test app you previously installed (or accepted an invitation for), it's likely that you signed in to the wrong Google account. The apps to which you have access are associated with the Google account you used when you first accepted the invitation to test the app. Try again by signing in with the Google account you previously used to accept the invitation.
When you encounter a 403 error, this means that the account you're using doesn't have permission to install and test apps. Access is determined by the administrator of your account's domain in Google Workspace.
If you believe you should have permission to install and test apps, ask your Google Workspace account admin to change your account settings. Your admin should follow the instructions in Manage access to services that aren't controlled individually .
If you have multiple accounts, try logging in with a different account that is not restricted from installing and testing apps.
Enabling in-app alerts with the App Distribution iOS SDK
Use the following tips to troubleshoot issues that involve enabling in-app new build alerts using the App Distribution iOS SDK.
If you have already set up the App Distribution iOS SDK in your app and your testers aren't receiving in-app alerts, check to make sure your app is fetching new releases:
Enable debug mode in your app. To learn how, see the Google Analytics documentation .
Run your app in a simulator and search for the string "[Firebase/AppDistribution]".
Check that the tester has access to the new release:
If a valid release object is returned, it's likely that there's an issue in the View Controller lifecycle where the alert dialog is loaded before the View appears.
If no release is returned, your tester may not yet be associated with the new release. In the App Distribution dashboard of the Firebase console, make sure your tester is included in your build distribution and is in the Accepted state.
If your tester still isn't receiving updates, ask them to follow the tips below to make sure they accepted the invitation to test your app and that they set up their testing device properly:
On the test device, sign into the Firebase App Distribution web clip. Remember to select the Google account you first used when you accepted the invitation to test the app.
Make sure that the new app release is available in the web clip.
By default, your testers only need to sign in to their Google account once to enable new build alerts and to install new builds. If your testers are being prompted to sign in again after closing and re-opening your app, follow these tips to make sure your App Distribution configuration is set up properly:
Check to make sure you've enabled the Firebase App Testers API. For more information, see Enable the App Distribution Tester API .
Under Key restrictions , make sure that the Firebase App Testers API is included in the list of allowed APIs.
If you typically clear UserDefaults on signing out, you may be clearing your tester's state. App Distribution stores a flag that indicates whether your tester has already signed into the app. For more information, see the GitHub repository .
Frequently asked questions
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
To add more testers, request a no-cost limit increase .
Testers have 30 days to accept an invitation to test the app before it expires. When an invitation is 5 days from expiring, an expiration notice appears in the Firebase console next to the tester on a release. An invitation can be renewed by resending it via the drop-down menu on the tester row.
See Register additional devices .
App releases are removed from App Distribution if one of the following conditions occurs:
- The app release is older than 150 days.
- You exceed the 1,000 app release limit, and the app release is older than the 1,000 most recent app releases.
For more information, see App Distribution supports a maximum of 1,000 releases .
After the app reaches or exceeds the 150-day expiration limit or the 1,000 app release limit, the release is removed from the App Distribution dashboard and the App Distribution tester web app. If your tester has installed the release, the local version of the app continues to run.
To keep the app release available longer, use one of the following recommendations:
- Before the app release expires or exceeds the release limit, download the IPA and delete the release from the App Distribution dashboard. Then, re-upload the IPA as a new build to App Distribution.
- Download the release and upload it to Cloud Storage for long-term archiving.
App releases expire after 150 days
When you upload a release of your app to Firebase, the release appears in the App Distribution dashboard for 150 days, starting from the upload date. After you upload the release, you can distribute it to testers, who install the release from the App Distribution tester web app on their testing device.
When the release is 30 days from the expiration date, an app release expiration notification appears on your release in the App Distribution page of the Firebase console and in the App Distribution tester web app.
App Distribution supports a maximum of 1,000 releases
App Distribution allows a maximum of 1,000 releases per app. When your app reaches the 1,000 app release limit, App Distribution automatically deletes the oldest releases above the limit.
If you want to manually manage your app releases, use the App Distribution REST API to list and delete app releases in bulk.
If you have questions, contact Firebase Support .
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 .
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.
To delete your App Distribution tester account and its associated data, follow these steps in order:
Visit https://appdistribution.firebase.google.com and sign in with your Google account.
In the top-right, click ( Manage account )
Delete account .
Optional: In your Google account permissions , revoke access from Firebase App Distribution. Note that revoking access without first deleting your App Distribution account does not delete your tester account or data.