Ta strona zawiera 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żesz napotkać ten błąd:
„Nie mogliśmy znaleźć kontaktowego adresu e-mail dla aplikacji <app-id>
. Przejdź do dystrybucji aplikacji w konsoli Firebase, aby go skonfigurować”.
Ustaw kontaktowy adres e-mail w konsoli Firebase, jeśli jest dostępny. Jeśli problem nie ustąpi, 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 do pomocy numer swojego 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 rozmiar 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 kroki:
Sprawdź plik
Info.plist
i potwierdź, czyCFBundleDisplayName
zawiera jakiekolwiek ograniczniki<array>
.Usuń ograniczniki
<array>
i odbuduj swoją aplikację. Przesyłanie powinno się udać.Jeśli nadal masz 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.
Gdy użytkownik tworzy konto Google, automatycznie otrzymuje adres Gmail.
Jeśli tester nie ma adresu Google Workspace lub Gmail albo woli używać innego adresu e-mail do logowania, poproś testera o powiązanie z kontem adresu e-mail spoza Gmaila i użycie 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ż połączony z innym kontem Google.
- Pamiętaj, aby podczas logowania się przy użyciu tego adresu e-mail używać hasła do konta Google.
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ż zaproszenie zostało wysłane, tester może nie być w stanie zobaczyć odpowiednich aplikacji lub kompilacji.
Wiadomość e-mail, na którą deweloper wysyła zaproszenia i którą dodaje do nowych kompilacji (e-mail A), może różnić się od wiadomości e-mail, której tester używa do zaakceptowania zaproszenia (e-mail B). Tworzy to łącze za kulisami. Za każdym razem, gdy e-mail A jest dodawany do nowych kompilacji, w rzeczywistości to e-mail B uzyskuje dostęp.
Jeśli tester zaakceptował zaproszenie e-mail z innym adresem e-mail, wykonaj następujące kroki, aby rozwiązać problem:
Usuń testera z karty Testerzy i grupy na stronie Dystrybucja aplikacji w konsoli Firebase. Istniejące zaproszenia są usuwane.
Zaproś testera ponownie 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 następujących sytuacji:
Powiadomienia e-mail są wysyłane do folderów ze spamem.
Filtry poczty e-mail są ustawione.
Zaproszenie zostało wysłane na jedno konto e-mail, ale tester przyjął inne konto e-mail. Tester otrzymuje wiadomości e-mail o nowej wersji dla konta e-mail, na które pierwotnie wysłane zostało zaproszenie.
Tester został wcześniej zaproszony, ale nie przyjął wstępnego zaproszenia. Jeśli tester zostanie dodany do kolejnych wersji, dystrybucja aplikacji nie będzie automatycznie wysyłać powiadomień o wersji do tego testera, ponieważ tester nie zaakceptował początkowego zaproszenia.
Rozwiązanie 1
Poproś testera, aby sprawdził folder spamu i wszelkie filtry poczty e-mail ustawione w usłudze poczty e-mail.
Jeśli tester zrezygnował z otrzymywania 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 na dole i kliknij Zezwalaj na e-maile na ponowną subskrypcję.
Rozwiązanie 2
Usuń testera z karty Testerzy i grupy na stronie Dystrybucja aplikacji w konsoli Firebase. Ta czynność usuwa istniejące zaproszenia.
Zaproś testera ponownie 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 zaproszenie zostało wysłane.
Błąd Niezaufany programista korporacyjny pojawia się, jeśli nie ufasz certyfikatowi programisty na urządzeniu testowym przed otwarciem aplikacji. Na ekranie Ustawienia > Profile i zarządzanie urządzeniami wybierz nazwę programisty aplikacji i zaufaj jej.
Jeśli instalujesz dystrybucję ad hoc, ten komunikat pojawia się, gdy programista nie skonfigurował jeszcze swojej aplikacji do uruchamiania na urządzeniu testowym. Aby udostępnić Ci aplikację, programista musi wykonać instrukcje opisane w sekcji 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 logujesz 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 wcześniej użyłeś do zaakceptowania zaproszenia.
Gdy napotkasz błąd 403, oznacza to, że używane konto nie ma uprawnień do instalowania i testowania aplikacji. Dostęp określa 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ę na inne konto, które nie jest ograniczone do instalowania i testowania aplikacji.
Włączanie alertów w aplikacji za pomocą zestawu SDK App Distribution iOS SDK
Skorzystaj z poniższych wskazówek, aby rozwiązywać problemy, które obejmują włączanie alertów nowej kompilacji w aplikacji przy użyciu zestawu SDK aplikacji App Distribution dla systemu iOS.
Jeśli masz już skonfigurowany pakiet App Distribution iOS SDK w swojej aplikacji, a Twoi testerzy nie otrzymują alertów w aplikacji, upewnij się, że 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ępuje problem w cyklu życia kontrolera widoku, w którym okno dialogowe alertu jest ładowane przed wyświetleniem widoku.
Jeśli żadna wersja nie zostanie zwrócona, tester może nie być jeszcze powiązany z nową wersją. Na pulpicie nawigacyjnym dystrybucji aplikacji konsoli Firebase upewnij się, że tester jest uwzględniony w dystrybucji kompilacji i znajduje się w stanie Zaakceptowany .
Jeśli Twój tester nadal nie otrzymuje aktualizacji, poproś go o zastosowanie się do 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, którego użyłeś po raz pierwszy, gdy przyjąłeś zaproszenie do przetestowania aplikacji.
Upewnij się, że nowa wersja aplikacji jest dostępna w klipie internetowym.
Domyślnie testerzy muszą tylko raz zalogować się na swoje konto Google, aby włączyć alerty o nowych kompilacjach i zainstalować nowe kompilacje. Jeśli testerzy są monitowani 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 sekcji Ograniczenia klucza upewnij się, że interfejs Firebase App Testers API znajduje się na liście dozwolonych interfejsów API.
Jeśli zazwyczaj po wylogowaniu wyczyścisz ustawienia UserDefaults, możliwe, że usuwasz stan 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
Firebase App Distribution ma następujące ograniczenia 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 zwiększenie bezpłatnego limitu .
Testerzy mają 30 dni na zaakceptowanie zaproszenia do przetestowania aplikacji przed jej wygaśnięciem. Po upływie 5 dni od wygaśnięcia zaproszenia w konsoli Firebase obok testera wersji pojawia się informacja o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie za pomocą menu rozwijanego w wierszu testera.
Wersje aplikacji są usuwane z dystrybucji aplikacji, jeśli wystąpi 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ń aplikacji.
Aby uzyskać więcej informacji, zobacz Dystrybucja aplikacji obsługuje maksymalnie 1000 wersji .
Gdy aplikacja osiągnie lub przekroczy 150-dniowy limit wygaśnięcia lub limit 1000 wersji aplikacji, wersja jest usuwana z pulpitu nawigacyjnego App Distribution i aplikacji internetowej testera App Distribution. 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 wydanie aplikacji wygaśnie lub przekroczy limit wersji, pobierz IPA i usuń wydanie z pulpitu nawigacyjnego App Distribution. Następnie ponownie prześlij IPA jako nową kompilację do aplikacji 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ę swojej aplikacji do Firebase, będzie ona widoczna 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 instalują wersję z aplikacji internetowej testera App Distribution na swoim urządzeniu testowym.
Gdy wydanie upłynie 30 dni od daty wygaśnięcia, powiadomienie o wygaśnięciu wersji aplikacji pojawi się w Twojej wersji na stronie Dystrybucja aplikacji w konsoli Firebase oraz w aplikacji internetowej Tester Dystrybucji aplikacji.
Dystrybucja aplikacji obsługuje maksymalnie 1000 wydań
Dystrybucja aplikacji umożliwia maksymalnie 1000 wydań na aplikację. Gdy Twoja aplikacja osiągnie limit 1000 wydań aplikacji, dystrybucja aplikacji automatycznie usuwa najstarsze wydania powyżej limitu.
Jeśli chcesz ręcznie zarządzać wydaniami aplikacji, użyj interfejsu App Distribution REST API, aby zbiorczo wyświetlać i usuwać wydania aplikacji.
Jeśli masz pytania, skontaktuj się z pomocą techniczną Firebase .
Profil Firebase to profil konfiguracji, 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 wiadomość e-mail zawierającą identyfikator UDID urządzenia testowego wraz z instrukcjami dołączania urządzenia do profilu aprowizacji aplikacji, aby można było przetestować kompilację na Twoim urządzeniu.
Zainstaluj wycinek internetowy Firebase App Distribution na ekranie głównym urządzenia. Klip internetowy umożliwia zainstalowanie i dostęp do wszystkich aplikacji testowych w jednym miejscu. Nowe kompilacje, do testowania 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ę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ę do Google i zaakceptuj zaproszenie.
W sekcji Testuj aplikacje wybierz aplikację, którą chcesz przetestować.
W prawym górnym rogu strony aplikacji kliknij mobile_screen_share .
Postępuj zgodnie z wyświetlanymi instrukcjami, aby zainstalować profil Firebase.
Aby usunąć swoje konto testera App Distribution 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 konta Google cofnij dostęp z 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.