Na tej stronie znajdziesz pomoc w rozwiązywaniu problemów oraz odpowiedzi na często zadawane pytania dotyczące dystrybucji i testowania aplikacji za pomocą aplikacji App Distribution.
Dystrybucja aplikacji
Skorzystaj z poniższych wskazówek, aby rozwiązać problemy, które możesz napotkać podczas dystrybucji aplikacji wśród testerów.
Podczas przesyłania aplikacji może pojawić się następujący błąd:
„Nie znaleźliśmy kontaktowego adresu e-mail dla aplikacji <app-id>
. Odwiedź stronę Dystrybucja aplikacji w konsoli Firebase, aby go 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 udostępniania wielokrotnie napotykasz błędy 400, 409 lub 500, skontaktuj się z pomocą techniczną Firebase . Zapewnij pomoc techniczną, podając 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ź wielkość IPA. Maksymalny limit rozmiaru pliku dla wszystkich plików binarnych wynosi 2048 MiB, czyli nieco ponad 2 GB.
Jeśli rozmiar IPA mieści się w limicie rozmiaru pliku i jest odtwarzalny, wykonaj następujące kroki:
Sprawdź plik
Info.plist
i potwierdź, czyCFBundleDisplayName
zawiera jakiekolwiek ograniczniki<array>
.Usuń ograniczniki
<array>
i odbuduj aplikację. Przesyłanie powinno zakończyć się pomyślnie.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 użycie Testflight .
Instalowanie i testowanie aplikacji
Skorzystaj z poniższych wskazówek, aby rozwiązać problemy, które mogą napotkać testerzy podczas instalowania i testowania aplikacji.
Kiedy użytkownik tworzy konto Google, automatycznie otrzymuje adres Gmail.
Jeśli tester nie ma adresu Google Workspace ani Gmaila albo woli do logowania się użyć innego adresu e-mail, poproś testera o powiązanie z kontem adresu e-mail innego niż Gmail i używanie tego adresu e-mail do logowania.
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ż powiązany z innym kontem Google.
- Pamiętaj, aby zalogować się przy użyciu tego adresu e-mail, używając hasła do konta Google.
Więcej informacji znajdziesz w artykule 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ż zaproszenie, na które zaproszenie zostało wysłane, tester może nie widzieć odpowiednich aplikacji lub kompilacji.
Adres e-mail, na który programista wysyła zaproszenia i dodaje je do nowych kompilacji (e-mail A), może różnić się od adresu e-mail, którego tester używa do zaakceptowania zaproszenia (e-mail B). Tworzy to połączenie za kulisami. Za każdym razem, gdy do nowych kompilacji dodawany jest adres e-mail A, w rzeczywistości dostęp do niego uzyskuje adres e-mail B.
Jeśli tester przyjął zaproszenie e-mail z innym adresem e-mail, wykonaj poniższe kroki, 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 aplikacji. Tester powinien otrzymać e-mail z zaproszeniem.
Upewnij się, że tester przyjął zaproszenie z tym samym adresem e-mail.
Testerzy mogą nie otrzymać powiadomień e-mail, jeśli wystąpi jedna z poniższych sytuacji:
Powiadomienia e-mail trafiają do folderów ze spamem.
Filtry poczty e-mail są ustawione.
Zaproszenie zostało wysłane na jedno konto e-mail, ale tester zaakceptował je, korzystając z innego konta e-mail. Tester otrzymuje e-maile 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 wydań, 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, aby sprawdził folder ze spamem i wszelkie filtry poczty e-mail ustawione w usłudze poczty e-mail.
Jeśli tester zrezygnował z subskrypcji e-maili, poproś testera o wykonanie następujących czynności:
- Znajdź e-mail, który tester otrzymał wcześniej z aplikacji.
- Kliknij Zarządzaj ustawieniami poczty e-mail na dole i kliknij Zezwól na ponowną subskrypcję wiadomości e-mail .
Rozwiązanie 2
Jeśli testerowi nie zależy na otrzymywaniu powiadomień e-mail i chce po prostu akceptować zaproszenia do aplikacji, może wyświetlić oczekujące zaproszenia do aplikacji bezpośrednio w klipie internetowym Firebase App Distribution: appdistribution.firebase.google.com .
Rozwiązanie 3
Usuń testera z sekcji Wyświetl wszystkich testerów na karcie Testerzy i grupy na stronie Dystrybucja aplikacji w konsoli Firebase. Ta czynność powoduje usunięcie istniejących zaproszeń.
Ponownie zaproś testera do przetestowania aplikacji. Tester powinien otrzymać e-mail z zaproszeniem. Upewnij się, że tester przyjął zaproszenie z tego samego adresu e-mail, na który zaproszenie zostało wysłane.
Błąd Niezaufany programista korporacyjny pojawia się, jeśli przed otwarciem aplikacji nie zaufałeś certyfikatowi programisty na urządzeniu testowym. Na ekranie Ustawienia aplikacji > Zarządzanie profilami i urządzeniami wybierz nazwę programisty aplikacji i zaufaj jej.
Błąd Wymagany tryb programisty pojawia się podczas próby uruchomienia aplikacji na iOS udostępnionej ad hoc 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 dotknij Prywatność i bezpieczeństwo .
- Przewiń w dół do opcji Bezpieczeństwo i dotknij Tryb programisty .
- Stuknij suwak Tryb programisty .
- Kliknij Uruchom ponownie .
- Po ponownym uruchomieniu urządzenia odblokuj je. Włączyć tryb programisty? pojawi się okno dialogowe.
- Kliknij 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 Twoim urządzeniu testowym. Aby udostępnić Ci aplikację, programista musi wykonać instrukcje zawarte w części Rejestracja dodatkowych urządzeń .
Jeśli Twoje konto Google nie ma dostępu do aplikacji testowej, którą wcześniej zainstalowałeś (lub do której przyjął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, którego użyłeś wcześniej do przyjęcia zaproszenia.
Gdy pojawi się błąd 403, oznacza to, że konto, którego używasz, nie ma uprawnień do instalowania i testowania aplikacji. Dostęp ustala administrator 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 zawartymi 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, na którym nie ma ograniczeń w zakresie instalowania i testowania aplikacji.
Włączanie alertów w aplikacji za pomocą zestawu SDK dystrybucji aplikacji dla systemu iOS
Skorzystaj z poniższych wskazówek, aby rozwiązać problemy związane z włączaniem alertów o nowych kompilacjach w aplikacji przy użyciu zestawu SDK dystrybucji aplikacji dla systemu iOS.
Jeśli w swojej aplikacji masz już skonfigurowany pakiet SDK aplikacji do dystrybucji aplikacji dla systemu iOS, 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, powodujący załadowanie okna dialogowego alertu przed pojawieniem się widoku.
Jeśli żadna wersja nie zostanie zwrócona, Twój tester może nie być jeszcze powiązany z nową wersją. Upewnij się, że na panelu dystrybucji aplikacji w konsoli Firebase Twój tester jest uwzględniony w Twojej dystrybucji kompilacji i ma stan Zaakceptowany .
Jeśli tester nadal nie otrzymuje aktualizacji, poproś go, aby zastosował się do poniższych wskazówek i upewnił się, że przyjął zaproszenie do przetestowania aplikacji oraz że prawidłowo skonfigurował urządzenie testowe:
Na urządzeniu testowym zaloguj się do klipu internetowego Firebase App Distribution. Pamiętaj, aby wybrać konto Google, którego użyłeś po raz pierwszy, przyjmując zaproszenie do testowania aplikacji.
Upewnij się, że nowa wersja aplikacji jest dostępna w klipie internetowym.
Domyślnie testerzy muszą zalogować się na swoje konto Google tylko raz, aby włączyć powiadomienia o nowych kompilacjach i zainstalować nowe kompilacje. Jeśli po zamknięciu i ponownym otwarciu aplikacji testerzy zostaną poproszeni o ponowne zalogowanie się, postępuj zgodnie z poniższymi wskazówkami, aby upewnić się, że konfiguracja Dystrybucji aplikacji jest prawidłowo skonfigurowana:
Sprawdź, czy masz włączony interfejs API testerów aplikacji Firebase. Aby uzyskać więcej informacji, zobacz Włączanie interfejsu API testera dystrybucji aplikacji .
W obszarze Ograniczenia klucza upewnij się, że interfejs API Firebase App Testers znajduje się na liście dozwolonych interfejsów API.
Jeśli zazwyczaj czyścisz ustawienia UserDefaults przy wylogowywaniu się, być może czyścisz stan testera. Dystrybucja aplikacji przechowuje flagę wskazującą, czy tester zalogował się już do aplikacji. Więcej informacji znajdziesz w 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 przyjęcie zaproszenia do przetestowania aplikacji, zanim wygaśnie. Gdy do wygaśnięcia zaproszenia pozostało 5 dni, w konsoli Firebase obok testera w wersji pojawi się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie za pomocą menu rozwijanego w wierszu testera.
Zobacz Rejestracja dodatkowych urządzeń .
Wersje aplikacji są usuwane z dystrybucji aplikacji, jeśli spełniony jest jeden z następujących warunków:
- Wersja aplikacji jest starsza niż 150 dni.
- Przekraczasz limit 1000 wydań aplikacji, a wersja aplikacji jest starsza niż 1000 najnowszych wydań.
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 panelu dystrybucji aplikacji i aplikacji internetowej testera dystrybucji aplikacji. Jeśli tester zainstalował tę wersję, lokalna wersja aplikacji będzie nadal działać.
Aby wersja aplikacji była dłużej dostępna, skorzystaj z jednego z poniższych zaleceń:
- Zanim wersja aplikacji wygaśnie lub przekroczy limit wersji, pobierz IPA i usuń wersję z panelu dystrybucji aplikacji. Następnie ponownie prześlij IPA jako nową kompilację do App Distribution.
- Pobierz wersję i prześlij ją do Cloud Storage w celu długoterminowej archiwizacji.
Wersje aplikacji wygasają po 150 dniach
Gdy prześlesz wersję 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 udostępnić ją testerom, którzy instalują ją z aplikacji internetowej testera dystrybucji aplikacji na swoim urządzeniu testowym.
Jeśli od daty wygaśnięcia wersji aplikacji minęło 30 dni, na jej stronie na stronie Dystrybucja aplikacji w konsoli Firebase oraz w aplikacji internetowej testera dystrybucji aplikacji pojawi się powiadomienie o wygaśnięciu wersji aplikacji.
Dystrybucja aplikacji obsługuje maksymalnie 1000 wydań
Dystrybucja aplikacji umożliwia maksymalnie 1000 wydań na aplikację. Kiedy Twoja aplikacja osiągnie limit 1000 wydań, usługa App Distribution automatycznie usuwa najstarsze wydania powyżej limitu.
Jeśli chcesz ręcznie zarządzać wydaniami aplikacji, użyj interfejsu API REST dystrybucji aplikacji, aby zbiorczo wyświetlać i usuwać wydania 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 twórcy aplikacji wiadomość e-mail zawierającą identyfikator UDID urządzenia testowego wraz z instrukcjami, jak uwzględnić urządzenie w profilu udostępniania aplikacji, aby można było przetestować kompilację na Twoim urządzeniu.
Zainstaluj klip internetowy Firebase App Distribution na ekranie głównym swojego urządzenia. Klip internetowy umożliwia instalację wszystkich aplikacji testowych i dostęp do nich w jednym miejscu. Nowe kompilacje, do przetestowania których jesteś zaproszony, są automatycznie dodawane do klipu internetowego.
Aby uzyskać pomoc dotyczącą instalowania profili konfiguracyjnych 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ędziesz mógł 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 obszarze Testuj aplikacje 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ąć swoje konto testera dystrybucji aplikacji i powiązane z nim dane, wykonaj w podanej kolejności następujące kroki:
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 konta Google odbierz dostęp z Firebase App Distribution. Pamiętaj, że cofnięcie dostępu bez uprzedniego usunięcia konta Dystrybucji aplikacji nie powoduje usunięcia konta testera ani danych.