Na tej stronie znajdziesz pomoc dotyczącą rozwiązywania problemów i odpowiedzi na najczęstsze pytania dotyczące rozpowszechniania i testowania aplikacji za pomocą App Distribution.
Dystrybucja aplikacji
Skorzystaj z podanych niżej wskazówek, aby rozwiązać problemy, które mogą wystąpić podczas rozpowszechniania aplikacji dla testerów.
Nie można rozpowszechniać aplikacji z powodu braku adresu e-mail do kontaktu
Podczas przesyłania aplikacji możesz napotkać ten błąd:
„Nie udało nam się znaleźć kontaktowego adresu e-mail dla aplikacji <app-id>
. Aby go skonfigurować, otwórz stronę App Distribution w konsoli Firebase.
Ustaw kontaktowy adres e-mail w konsoli Firebase, jeśli jest dostępny. Jeśli problem będzie się powtarzał, skontaktuj się z zespołem pomocy Firebase.
Podczas udostępniania aplikacji wystąpił błąd (błędy 400, 409 lub 500)
Jeśli podczas udostępniania wielokrotnie występują błędy 400, 409 lub 500, skontaktuj się z zespołem pomocy Firebase. Podaj zespołowi pomocy numer projektu Firebase i identyfikator aplikacji.
Nie udało się przesłać pliku IPA
Oto przykład odpowiedzi sieci 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:
Sprawdź rozmiar pliku IPA. Maksymalny rozmiar pliku binarnego to 2048 MiB, czyli nieco ponad 2 GB.
Jeśli rozmiar pliku IPA mieści się w limitach i można go odtworzyć, wykonaj te czynności:
Sprawdź plik
Info.plist
i potwierdź, żeCFBundleDisplayName
zawiera dowolne ograniczniki<array>
.Usuń rozdzielacze
<array>
i ponownie skompiluj aplikację. Przesyłanie powinno się udać.Jeśli problemy nadal występują, skontaktuj się z zespołem pomocy Firebase.
Jeśli rozmiar IPA przekracza limit rozmiaru pliku, wprowadź niezbędne zmiany w zmniejsz rozmiar pliku.
Jeśli zmniejszenie rozmiaru pliku IPA nie rozwiąże problemu, skontaktuj się z zespołem pomocy Firebase i zapytaj o użycie Testflight.
Instalowanie i testowanie aplikacji
Postępuj zgodnie z poniższymi wskazówkami, aby rozwiązywać problemy, które mogą napotkać testerzy napotkanych podczas instalowania i testowania aplikacji.
Tester nie ma konta Google
Gdy użytkownik tworzy konto Google, automatycznie otrzymuje adres Gmail.
Jeśli tester nie ma adresu Google Workspace ani adresu Gmail lub zamiast korzystać z innego adresu e-mail, poproś testera o połączenie konta adres e-mail do swojego konta i użyj go do zalogowania się.
Wybierając alternatywny adres e-mail, tester musi przestrzegać tych wytycznych:
- Nie używaj adresu Gmail.
- Nie używaj adresu e-mail, który jest już połączony z innym kontem Google.
- Pamiętaj, że musisz podawać hasło do konta Google, gdy logujesz się przy użyciu tego adresu e-mail.
Więcej informacji znajdziesz w artykule Logowanie się na konto Google przy użyciu innego adresu e-mail.
Testerzy nie widzą odpowiednich aplikacji lub kompilacji
Jeśli tester zaakceptował e-maila z zaproszeniem, podając inny adres e-mail niż tester może nie widzieć właściwych aplikacji lub do tworzenia kampanii.
Adres e-mail, na który deweloper wysyła zaproszenia i dodaje nowe wersje (adres A), może być inny niż adres e-mail, którego tester używa do akceptowania zaproszenia (adres B). Spowoduje to utworzenie linku w tylu. Gdy e-mail A zostaje dodany do nowych wersji, dostęp uzyskuje e-mail B.
Jeśli tester zaakceptował e-maila z zaproszeniem, korzystając z innego adresu e-mail, wykonaj te czynności, aby rozwiązać problem:
Usuń testera w sekcji Wyświetl wszystkich testerów na karcie Testerzy i grupy na stronie App Distribution konsoli Firebase. Istniejące zaproszenia zostaną usunięte.
Ponownie zaproś testera do przetestowania aplikacji. Tester powinien otrzymać e-maila z zaproszeniem.
Sprawdź, czy tester zaakceptował zaproszenie z tego samego adresu e-mail.
Tester nie otrzymuje e-maili z powiadomieniami
Testerzy mogą nie otrzymywać e-maili z powiadomieniami, jeśli:
E-maile z powiadomieniami są wysyłane do folderów ze spamem.
Filtry e-maili są ustawione.
Zaproszenie zostało wysłane na 1 konto e-mail, ale tester je zaakceptował, podając innego konta e-mail. Tester otrzymuje e-maile z informacjami o nowych wersjach na konto e-mail, na które zostało wysłane pierwotne zaproszenie.
Tester został wcześniej zaproszony, ale nie zaakceptował pierwszego zaproszenia. Jeśli tester zostanie dodany do kolejnych wersji, App Distribution nie będzie automatycznie wysyłać powiadomień o wersjach do tego testera, ponieważ nie zaakceptował on początkowego zaproszenia.
Rozwiązanie 1
Poproś testera o sprawdzenie folderu ze spamem i filtrów ustawionych w usługach poczty e-mail.
Jeśli tester anulował subskrypcję e-maili, poproś go o wykonanie tych czynności:
- Znajdź e-maila, który tester otrzymał wcześniej od aplikacji.
- U dołu kliknij Zarządzaj ustawieniami poczty e-mail, a następnie wybierz Zezwól na e-maile. aby ponownie wykupić subskrypcję.
Rozwiązanie 2
Jeśli testerowi nie zależy na powiadomienia e-mail i chce po prostu akceptować zaproszenia do aplikacji, wyświetlać 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 w sekcji Testerzy i Karta Grupy w: App Distribution w konsoli Firebase. Ta czynność spowoduje usunięcie istniejących zaproszeń.
Ponownie zaproś testera do przetestowania aplikacji. Tester powinien otrzymać e-maila z zaproszeniem. Upewnij się, że tester zaakceptuje zaproszenie z tego samego adresu e-mail, na który zostało ono wysłane.
„Niezaufany deweloper dla firm” podczas próby uruchomienia aplikacji testowej
Błąd Nieuczciwy deweloper korporacyjny pojawia się, jeśli przed otwarciem aplikacji nie zaufasz certyfikatowi dewelopera na urządzeniu testowym. Na ekranie Ustawienia > Profile i zarządzanie urządzeniami wybierz nazwę dewelopera aplikacji i mu zaufaj.
„Wymagany tryb programisty” podczas próby uruchomienia aplikacji testowej
Przy próbie uruchomienia reklamy pojawia się błąd „Wymagany tryb programisty” aplikacja na iOS w wersji 16 lub nowszej bez wcześniejszego włączenia funkcji deweloperskiej Tryb.
Aby włączyć tryb programisty i usunąć ten błąd, wykonaj te czynności:
- Na iPhonie otwórz aplikację Ustawienia, a potem kliknij Prywatność i wyświetlanie Bezpieczeństwo.
- Przewiń w dół do sekcji Bezpieczeństwo i kliknij Tryb programisty.
- Kliknij suwak Tryb programisty.
- Kliknij Uruchom ponownie.
- Po ponownym uruchomieniu urządzenia odblokuj je. Pojawi się okno „Włącz tryb programisty?”.
- Kliknij Włącz. Możesz teraz uruchomić aplikację i rozpocząć testowanie.
"Urządzenie zostało zarejestrowane. Wszystko gotowe! Gdy aplikacja będzie gotowa do testów, otrzymasz e-maila”.
Jeśli instalujesz wersję Ad Hoc, ten komunikat pojawi się, gdy deweloper nie skonfigurował jeszcze aplikacji do działania na urządzeniu testowym. Aby udostępnić Ci aplikację, deweloper musi wykonać instrukcje podane w sekcji Rejestrowanie dodatkowych urządzeń.
Konto Google nie ma dostępu do aplikacji testowej
Jeśli Twoje konto Google nie ma dostępu do aplikacji testowej, którą wcześniej zainstalowałeś(-aś) (lub do której zaakceptowałeś(-aś zaproszenie), prawdopodobnie zalogowałeś(-aś) się na niewłaściwe konto Google. Aplikacje, do których masz dostęp powiązane z kontem Google użytym do zaakceptowania do testowania aplikacji. Zaloguj się na konto Google i spróbuj jeszcze raz które zostało użyte do zaakceptowania zaproszenia.
Błąd 403: „Aby uzyskać dostęp, skontaktuj się z administratorem”
Gdy pojawi się 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 przysługuje Ci uprawnienie do instalowania i testowania aplikacji, poproś administratora konta Google Workspace o zmianę ustawień konta. Administrator powinien wykonać czynności opisane w artykule Zarządzanie dostępem do usług, które nie mają własnych opcji włączania i wyłączania.
Jeśli masz kilka kont, spróbuj zalogować się na inne, które nie ma ograniczonych możliwości instalowania i testowania aplikacji.
Włączanie alertów w aplikacji za pomocą pakietu SDK na iOS (App Distribution)
Aby rozwiązać problemy związane z włączaniem alertów o nowej wersji aplikacji za pomocą pakietu SDK na iOS App Distribution, skorzystaj z podanych niżej wskazówek.
Tester nie otrzymuje alertów w aplikacji
Jeśli w swojej aplikacji masz już skonfigurowany pakiet SDK App Distribution na iOS, a testerzy nie otrzymują alertów w aplikacji, sprawdź, czy aplikacja pobiera nowe wersje:
Włącz tryb debugowania w swojej aplikacji. Aby dowiedzieć się, jak to zrobić, przeczytaj dokumentacji Google Analytics.
Uruchom aplikację w symulatorze i poszukaj ciągu „[Firebase/AppDistribution]”.
Sprawdź, czy tester ma dostęp do nowej wersji:
Jeśli zwracany jest prawidłowy obiekt wersji, prawdopodobnie w cyklu życia kontrolera widoku danych, w którym pojawia się okno alertu wczytywane przed wyświetleniem widoku.
Jeśli nie zostanie zwrócona żadna wersja, testujący może nie być jeszcze powiązany z nową wersją. Na panelu App Distribution w konsoli Firebase sprawdź, czy tester jest uwzględniony w rozpowszechnianiu wersji kompilacji i czy ma stan Zaakceptowany.
Jeśli tester nadal nie otrzymuje aktualizacji, poproś go o postępowanie zgodnie z wskazówek poniżej, by upewnić się, że użytkownik zaakceptował zaproszenie do przetestowania oraz że prawidłowo skonfigurował urządzenie testowe:
Na urządzeniu testowym zaloguj się w aplikacji internetowej Firebase App Distribution. Pamiętaj, aby wybrać konto Google, którego użyto podczas akceptowania zaproszenia do przetestowania aplikacji.
Upewnij się, że nowa wersja aplikacji jest dostępna w klipie internetowym.
po zamknięciu aplikacji tester został poproszony o ponowne zalogowanie się.
Domyślnie testerzy muszą zalogować się na swoje konto Google tylko raz, aby: włączyć alerty o nowych kompilacjach i instalować nowe kompilacje. Jeśli testerzy po zamknięciu i ponownym uruchomieniu aplikacji pojawi się prośba o zalogowanie się, wykonaj te czynności: kilka wskazówek, jak upewnić się, że konfiguracja App Distribution jest prawidłowa:
Sprawdź, czy masz włączony interfejs Firebase App Testers API. Więcej więcej informacji znajdziesz w artykule Włączanie interfejsu App Distribution Tester API.
W sekcji Ograniczenia kluczy sprawdź, czy interfejs Firebase App Testers API jest na liście dozwolonych interfejsów API.
Jeśli podczas wylogowania użytkownik zwykle usuwa ustawienie UserDefaults, możliwe, że o stanie testera. App Distribution przechowuje flagę wskazującą, czy Twój tester zalogował się już w aplikacji. Więcej informacji znajdziesz w repozytorium GitHub.
Najczęstsze pytania
Czy są jakieś limity dodawania testerów do aplikacji?
Firebase App Distribution ma te limity testerów:
Dodawanie do projektu Firebase maksymalnie 500 testerów
Do grupy App Distribution możesz dodać maksymalnie 200 testerów
Aby dodać więcej testerów, poproś o bezpłatne zwiększenie limitu.
Czy moje zaproszenia do testowania wygasają?
Testerzy mają 30 dni na zaakceptowanie zaproszenia do testowania aplikacji, zanim wygaśnie. Jeśli zaproszenie wygasa po 5 dniach, w sekcji Konsola Firebase obok testera przy wersji. Zaproszenie można odnowić, wysyłając je ponownie za pomocą menu w wierszu testera.
Kiedy tworzona jest nowa wersja w przypadku przesyłań na iOS?
Jak długo dostępne są wersje aplikacji?
Wersje aplikacji są usuwane z App Distribution, jeśli wystąpi jeden z tych warunków:
- Wersja aplikacji jest starsza niż 150 dni.
- Przekraczasz limit 1000 wersji aplikacji, a wersja aplikacji jest starsza niż z 1000 najnowszych wersji aplikacji.
Więcej informacji znajdziesz w artykule App Distribution obsługuje maksymalnie 1000 wydań.
Gdy aplikacja osiągnie lub przekroczy limit 150 dni lub limit 1000 wersji, zostanie usunięta z poziomu App Distribution w panelu oraz z App Distribution w aplikacji internetowej dla testerów. Jeśli tester zainstalował wersję, lokalna wersja aplikacji będzie nadal działać.
Aby wersja aplikacji była dostępna dłużej, zastosuj jedną z tych rekomendacji:
- Zanim wersja aplikacji wygaśnie lub przekroczy limit wersji, pobierz IPA i usuń wersję z panelu App Distribution. Następnie prześlij plik IPA jako nową wersję na adres App Distribution.
- Pobierz wersję i prześlij ją do Cloud Storage na potrzeby długoterminowej archiwizacji.
Wersje aplikacji wygasają po 150 dniach
Gdy prześlesz wersję aplikacji do Firebase, pojawi się ona na stronie App Distribution przez 150 dni, licząc od daty przesłania. Po przesłaniu wersji może udostępnić ją testerom, którzy zainstalują wersję z App Distribution aplikację internetową testera na urządzeniu testowym.
Gdy do daty wygaśnięcia pozostało 30 dni, na stronie App Distribution w konsoli Firebase i w aplikacji internetowej dla testerów App Distribution pojawi się powiadomienie o wygaśnięciu wersji aplikacji.
App Distribution obsługuje maksymalnie 1000 wersji
App Distribution pozwala na maksymalnie 1000 wersji aplikacji. Gdy liczba wersji aplikacji osiągnie limit 1000, App Distribution automatycznie usunie najstarsze wersje, które przekroczyły ten limit.
Jeśli chcesz ręcznie zarządzać wersjami aplikacji, użyj interfejsu API REST App Distribution do listy i usuń zbiorczych wersji aplikacji.
Jeśli masz pytania, skontaktuj się z zespołem pomocy Firebase.
Co to jest profil Firebase?
Profil Firebase to profil konfiguracji, który umożliwia App Distribution:
Zarejestruj urządzenie testowe, zbierając jego unikalny identyfikator urządzenia (UDID). Jeśli testujesz rozpowszechnianie Ad Hoc, Firebase wysyła do dewelopera e-maila z identyfikatorem UDID urządzenia testowego oraz instrukcjami dodania urządzenia do profilu zarzadzania aplikacją, aby można było przetestować wersję na urządzeniu.
Zainstaluj klip internetowy Firebase App Distribution na ekranie głównym urządzenia. Klip z internetu umożliwia instalowanie wszystkich aplikacji testowych i korzystanie z nich w jednym miejscu. Nowe wersje, które możesz testować, są automatycznie dodawane do klipu internetowego.
Informacje o instalowaniu profili konfiguracji na urządzeniu z iOS znajdziesz tutaj: Dokumentacja Apple
Jak mogę uzyskać dostęp do aplikacji testowych zainstalowanych na moim urządzeniu?
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 testowanego urządzenia po zainstalowaniu profilu Firebase. Jeśli testujesz Dystrybucję ad hoc, musisz najpierw zainstalować profil przed jej przetestowaniem.
Jeśli testujesz Dystrybucja w firmie, możesz zainstalować profil ręcznie:
Zaloguj się w Google i zaakceptuj zaproszenie.
W sekcji Aplikacje testowe wybierz aplikację, którą chcesz przetestować.
W prawym górnym rogu strony aplikacji kliknij mobile_screen_share.
Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby zainstalować profil Firebase.
Jak usunąć konto testera?
Aby usunąć konto testera App Distribution i powiązane z nim dane: wykonaj te kroki w odpowiedniej kolejności:
Wejdź na stronę https://appdistribution.firebase.google.com. i zaloguj się na swoje konto Google.
W prawym górnym rogu kliknij settings (Zarządzaj kontem).
Usuń konto.
Opcjonalnie: w uprawnieniach konta Google cofnij dostęp aplikacji Firebase App Distribution. Pamiętaj, że odebranie dostępu bez pierwsze usunięcie konta App Distribution nie spowoduje usunięcia testera konta lub danych.