Na tej stronie znajdziesz pomoc w rozwiązywaniu problemów i odpowiedzi na najczęstsze pytania Pytania dotyczące dystrybucji i testowania aplikacji za pomocą App Distribution.
Dystrybucja aplikacji
Aby rozwiązać problemy, które mogą wystąpić podczas rozpowszechniania aplikacji wśród testerów, skorzystaj z podanych niżej wskazówek.
Nie można udostępnić aplikacji z powodu brakującego kontaktowego adresu e-mail
Podczas przesyłania aplikacji może pojawić się 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 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 powtarzają się błędy 400, 409 lub 500, skontaktuj się z zespołem pomocy Firebase. Podaj Pomoc w zakresie numeru projektu Firebase i identyfikatora 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 wszystkich plików binarnych wynosi 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 sprawdź, czy zawiera on jakiekolwiek rozdzielacze<array>
.Usuń ograniczniki (
<array>
) i skompiluj ponownie aplikację. Plik powinien przesłać odnieść sukces.Jeśli nadal masz problemy, skontaktuj się z zespołem pomocy Firebase.
Jeśli rozmiar pliku IPA przekracza limit rozmiaru pliku, wprowadź odpowiednie zmiany, aby zmniejszyć rozmiar pliku.
Jeśli zmniejszenie rozmiaru pliku IPA nie rozwiąże problemu, skontaktuj się z Zespół pomocy Firebase i zapytaj o korzystanie Okres testowy.
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 utworzy konto Google, automatycznie otrzyma 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 dodatkowy adres e-mail, tester musi przestrzegać tych 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, by podczas logowania się za pomocą tego adresu e-mail użyć hasła do konta Google adresu.
Więcej informacji znajdziesz w artykule Logowanie się na konto Google przy użyciu innego adresu e-mail.
Tester nie widzi odpowiednich aplikacji lub kompilacji
Jeśli tester zaakceptuje zaproszenie e-mail z innego adresu e-mail niż ten, na który zostało wysłane, może nie widzieć odpowiednich aplikacji ani wersji.
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). W ten sposób powstanie link w tle. Zawsze, gdy e-mail A jest dodany do nowych kompilacji, dostęp do niego ma w rzeczywistości adres e-mail B.
Jeśli tester zaakceptował e-maila z zaproszeniem, używając innego adresu e-mail, Aby rozwiązać problem, wykonaj następujące czynności:
Usuń testera z sekcji Wyświetl wszystkich testerów w sekcji Testerzy i Karta Grupy w: App Distribution w 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ć powiadomień e-mail, jeśli wystąpi jedno z tych zdarzeń:
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 wypuszczeniu, ponieważ nie zaakceptował on początkowego zaproszenia.
Rozwiązanie 1
Poproś testera o sprawdzenie folderu ze spamem i filtrów ustawionych w usłudze poczty e-mail.
Jeśli tester zrezygnował z subskrypcji e-maili, poproś go o wykonanie tych czynności: :
- Znajdź e-maila, którego tester wcześniej otrzymał z aplikacji.
- U dołu kliknij Zarządzaj ustawieniami poczty e-mail, a następnie 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 w sekcji Wyświetl wszystkich testerów na karcie Testerzy i grupy na stronie App Distribution w konsoli Firebase. To działanie 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 wysłane.
Błąd „Nieuczciwy deweloper korporacyjny” podczas próby uruchomienia testowej aplikacji
Jeśli tak się nie stało, pojawi się błąd Niezaufany programista Enterprise. zaufać certyfikatowi dewelopera na urządzeniu testowym przed otwarciem aplikacji. W aplikacji Ustawienia > Profile i Zarządzanie urządzeniami, wybierz nazwę dewelopera aplikacji i zaufać jej.
„Wymagany tryb programisty” podczas próby uruchomienia aplikacji testowej
Błąd „Wymagany tryb programisty” pojawia się, gdy próbujesz uruchomić aplikację na iOS 16 lub nowszy, która została udostępniona ad hoc, bez wcześniejszego włączenia trybu programisty.
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 Trybu programisty.
- Kliknij Uruchom ponownie.
- Gdy urządzenie uruchomi się ponownie, odblokuj je. Włączyć tryb programisty? które się wyświetla.
- Kliknij Włącz. Możesz teraz uruchomić aplikację i rozpocząć jej testy.
"Urządzenie zostało zarejestrowane. Wszystko gotowe! Gdy aplikacja będzie gotowa do testów, otrzymasz e-maila”.
Jeśli instalujesz dystrybucję ad hoc, ten komunikat pojawia się przy nie skonfigurował jeszcze aplikacji tak, aby działała na Twoim urządzeniu testowym. Deweloper musi wykonaj czynności opisane w artykule Rejestrowanie dodatkowych urządzeń.
Konto Google nie ma dostępu do aplikacji testowej
Jeśli Twoje konto Google nie ma wcześniej dostępu do aplikacji testowej Użytkownik zainstalował (lub zaakceptował zaproszenie), prawdopodobnie na niewłaściwe konto Google. Aplikacje, do których masz dostęp, są powiązane z kontem Google, którego użyto podczas akceptacji zaproszenia do przetestowania aplikacji. Spróbuj jeszcze raz, logując się na konto Google, którego użyto 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 uprawnienia 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)
Skorzystaj z podanych niżej wskazówek, aby rozwiązać problemy, włącz alerty o nowych kompilacji w aplikacji za pomocą pakietu SDK na iOS w systemie App Distribution.
Testerzy nie otrzymują powiadomień w aplikacji
Jeśli w aplikacji masz już skonfigurowany pakiet SDK App Distribution na iOS testerzy nie otrzymują alertów w aplikacji, sprawdź, czy pobieranie nowych wydań:
Włącz tryb debugowania w swojej aplikacji. Aby dowiedzieć się, jak to zrobić, przeczytaj dokumentacji Google Analytics.
Uruchom swoją aplikację w symulatorze i wyszukaj ciąg „[Firebase/App Distribution]”.
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 żadna wersja nie została zwrócona, Twój tester może nie być jeszcze powiązany z kontem 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 wydawca zaakceptował zaproszenie do przetestowania oraz że prawidłowo skonfigurował urządzenie testowe:
Na urządzeniu testowym zaloguj się w witrynie Firebase App Distribution klip. Pamiętaj, aby wybrać konto Google, którego użyto po raz pierwszy, gdy akceptowano zaproszenie do przetestowania aplikacji.
Upewnij się, że nowa wersja aplikacji jest dostępna w klipie internetowym.
Po zamknięciu aplikacji tester prosi 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 API Testerzy aplikacji Firebase. 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ę, która wskazuje, Tester jest już zalogowany w aplikacji. Więcej informacji: 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łatnych wyników zwiększenie limitu.
Czy zaproszenia dla testerów wygasają?
Testerzy mają 30 dni na zaakceptowanie zaproszenia do testowania aplikacji, zanim utraci ono ważność. Jeśli zaproszenie wygasa po 5 dniach, na stronie Konsola Firebase obok testera przy wersji. Zaproszenie można odnowić Wyślij ją ponownie, korzystając z menu w wierszu testera.
Kiedy jest tworzona nowa wersja do przesyłania na iOS?
Jak długo dostępne są wersje aplikacji?
Wersje aplikacji są usuwane z pakietu App Distribution, jeśli jedna z tych sytuacji: zachodzi sytuacja:
- 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 wersji.
Gdy aplikacja osiągnie lub przekroczy limit 150 dni lub limit 1000 wersji, zostanie usunięta z panelu App Distribution i aplikacji internetowej App Distribution dla testera. Jeśli tester zainstalował wersję, lokalna wersja aplikacji będzie nadal działać.
Aby wersja aplikacji była dłużej dostępna, skorzystaj z jednej 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.
Jeśli upłynie 30 dni od daty ważności, kolejne wersje aplikacji powiadomienie o wygaśnięciu wyświetla się w wersji na stronie App Distribution w konsoli Firebase i w aplikacji internetowej do testów w App Distribution.
App Distribution obsługuje maksymalnie 1000 wersji
App Distribution zezwala na maksymalnie 1000 wersji na aplikację. Gdy Twoja aplikacja osiągnie limit 1000 wersji, App Distribution automatycznie usuwa najstarsze przekroczy limit.
Jeśli chcesz ręcznie zarządzać wersjami aplikacji, użyj interfejsu API REST App Distribution, aby wyświetlić i usunąć wersje aplikacji zbiorczo.
Jeśli masz pytania, skontaktuj się z zespołem pomocy Firebase.
Co to jest profil Firebase?
Profil Firebase to profil konfiguracji, dzięki któremu App Distribution może:
Rejestrowanie urządzenia testowego przez zbieranie jego unikalnego identyfikatora (UDID). Jeśli testujesz dystrybucję doraźną, Firebase wysyła aplikację programisty e-maila zawierającego identyfikator UDID urządzenia testowego oraz instrukcje dodawania urządzenia do obsługi administracyjnej aplikacji profilu, tak by kompilację można było przetestować na urządzeniu.
Zainstaluj klip internetowy Firebase App Distribution na urządzeniu domowym ekranu. Dzięki klipowi internetowemu możesz instalować wszystkie aplikacje testowe i dostęp do nich uzyskać w jednym miejscu. Nowe kompilacje, do których masz zaproszenie do testowania, automatycznie dodane do klipu internetowego.
Aby dowiedzieć się więcej o instalowaniu profili konfiguracyjnych na urządzeniu z iOS, zapoznaj się z dokumentacją Apple.
Jak uzyskać dostęp do aplikacji testowych zainstalowanych na urządzeniu?
Jeśli jesteś testerem, możesz uzyskać dostęp do wszystkich swoich aplikacji testowych za pomocą Klip internetowy Firebase App Distribution, który jest automatycznie dodawany do testu na ekranie głównym 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 wyświetlanymi instrukcjami, 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 sekcji Uprawnienia dotyczące konta Google: cofnij dostęp dla: Firebase App Distribution. Pamiętaj, że odebranie dostępu bez pierwsze usunięcie konta App Distribution nie spowoduje usunięcia testera konta lub danych.