Na tej stronie znajdziesz pomoc w rozwiązywaniu problemów oraz odpowiedzi na najczęstsze pytania dotyczące dystrybucji i testowania aplikacji za pomocą Rozpowszechniania aplikacji.
Dystrybucja aplikacji
Aby rozwiązać problemy, które możesz napotkać przy dystrybuowaniu aplikacji testerom, skorzystaj z poniższych 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>
. Otwórz Rozpowszechnianie aplikacji w konsoli Firebase, aby je skonfigurować”.
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 obsługi administracyjnej wystąpią powtarzające się błędy 400, 409 lub 500, skontaktuj się z zespołem pomocy Firebase. Podaj 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 wszystkich plików binarnych wynosi 2048 MiB, czyli nieco powyżej 2 GB.
Jeśli rozmiar pliku IPA mieści się w limicie rozmiaru pliku i można go odtworzyć, wykonaj te czynności:
Sprawdź plik
Info.plist
i upewnij się, żeCFBundleDisplayName
zawiera ograniczniki<array>
.Usuń ograniczniki kolumny
<array>
i ponownie skompiluj aplikację. Przesyłanie powinno się zakończyć.Jeśli nadal masz problemy, skontaktuj się z zespołem pomocy 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 zespołem pomocy Firebase i poproś o użycie Testflight.
Instalowanie i testowanie aplikacji
Skorzystaj z podanych niżej wskazówek, aby rozwiązać problemy, które testerzy mogą napotkać 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 albo chce zalogować się przy użyciu innego adresu e-mail, poproś go o połączenie z kontem adresu e-mail spoza Gmaila i użycie tego adresu do logowania.
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, aby przy logowaniu się za pomocą tego adresu e-mail podać hasło do konta Google.
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 zaakceptował e-maila z zaproszeniem z innego adresu e-mail niż adres, na który zostało wysłane zaproszenie, może nie być w stanie zobaczyć odpowiednich aplikacji lub kompilacji.
Adres e-mail, do którego deweloper wysyła zaproszenia i dodaje nowe kompilacje (adres e-mail A), może się różnić od adresu e-mail używanego przez testera do zaakceptowania zaproszenia (e-mail B). W ten sposób powstanie link w tle. Za każdym razem, gdy jest dodawany e-mail A do nowych kompilacji, dostęp do niego ma w rzeczywistości e-mail B.
Jeśli tester zaakceptował e-maila z zaproszeniem, używając innego adresu e-mail, wykonaj te czynności, aby rozwiązać problem:
Usuń testera z sekcji Wyświetl wszystkich testerów na karcie Testerzy i grupy na stronie Rozpowszechnianie aplikacji w konsoli Firebase. Istniejące zaproszenia zostaną usunięte.
Ponownie zaproś testera do przetestowania aplikacji. Powinien on 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.
Ustawiono filtry e-maili.
Zaproszenie zostało wysłane na 1 konto e-mail, ale tester zaakceptował zaproszenie na innym koncie. Tester otrzymuje e-maile o nowych wersjach usługi na konto e-mail, na które pierwotnie wysłano zaproszenie.
Tester został wcześniej zaproszony, ale nie zaakceptował pierwszego zaproszenia. Jeśli tester zostanie dodany do kolejnych wersji, Rozpowszechnianie aplikacji nie będzie automatycznie wysyłać do niego powiadomień o wersjach, ponieważ nie zaakceptował pierwszego zaproszenia.
Rozwiązanie 1
Poproś testera o sprawdzenie folderu ze spamem i wszystkich filtrów poczty e-mail 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.
- Aby ponownie włączyć subskrypcję, na dole kliknij Zarządzaj ustawieniami poczty e-mail, a następnie Zezwalaj na e-maile.
Rozwiązanie 2
Jeśli testerowi nie zależy na powiadomieniach e-mail i chce po prostu mieć możliwość przyjmowania zaproszeń do aplikacji, może wyświetlać oczekujące zaproszenia bezpośrednio w klipie internetowym Rozpowszechniania aplikacji przez Firebase: appdistribution.firebase.google.com.
Rozwiązanie 3
Usuń testera z sekcji Wyświetl wszystkich testerów na karcie Testerzy i grupy na stronie Rozpowszechnianie aplikacji w konsoli Firebase. Ta czynność spowoduje usunięcie istniejących zaproszeń.
Ponownie zaproś testera do przetestowania aplikacji. Powinien on otrzymać e-maila z zaproszeniem. Sprawdź, czy tester zaakceptował zaproszenie z tego samego adresu e-mail, na który zostało wysłane.
Błąd „Niezaufany deweloper przedsiębiorstwa” podczas próby uruchomienia aplikacji testowej
Jeśli przed otwarciem aplikacji nie masz zaufania do certyfikatu dewelopera na urządzeniu testowym, pojawi się błąd Niezaufany deweloper Enterprise. Na ekranie aplikacji Ustawienia > Profile i zarządzanie urządzeniami wybierz nazwę dewelopera aplikacji i zaufaj jej.
Błąd „Wymagany tryb programisty” podczas próby uruchomienia aplikacji testowej
Błąd „Wymagany tryb programisty” pojawia się przy próbie uruchomienia doraźnej aplikacji na iOS na iOS w wersji 16 lub nowszej 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 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. Pojawi się okno dialogowe Włączyć tryb programisty?
- 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ę wtedy, gdy deweloper nie skonfigurował jeszcze aplikacji do działania na urządzeniu testowym. Aby udostępnić Ci aplikację, deweloper musi wykonać czynności opisane w artykule Rejestrowanie dodatkowych urządzeń.
Konto Google nie ma dostępu do aplikacji testowej
Jeśli na Twoim koncie Google nie ma dostępu do wcześniej zainstalowanej aplikacji testowej (lub przyjętej do niej zaproszenia), prawdopodobnie logujesz się na niewłaściwe konto Google. Aplikacje, do których masz dostęp, są powiązane z kontem Google użytym do zaakceptowania zaproszenia do testowania aplikacji. Spróbuj ponownie, logując się na konto Google użyte wcześniej do przyjęcia zaproszenia.
Błąd 403: „Aby uzyskać dostęp, skontaktuj się z administratorem”
Pojawienie się błędu 403 oznacza, ż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 App Distribution na iOS
Skorzystaj z podanych niżej wskazówek, aby rozwiązać problemy związane z włączaniem alertów dotyczących nowych kompilacji w aplikacji za pomocą pakietu SDK App Distribution na iOS.
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. Więcej informacji znajdziesz w 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 widoków wystąpił problem, w którym okno alertu jest wczytywane przed pojawieniem się widoku.
Jeśli nie zostanie zwrócona żadna wersja, tester może nie być jeszcze powiązany z nową wersją. W panelu Rozpowszechniania aplikacji w konsoli Firebase sprawdź, czy tester znajduje się w dystrybucji kompilacji i ma stan Zaakceptowano.
Jeśli tester nadal nie otrzymuje aktualizacji, poproś go o wykonanie poniższych wskazówek, by mieć pewność, że zaakceptował zaproszenie do testowania aplikacji i że prawidłowo skonfigurował urządzenie testowe:
Na urządzeniu testowym zaloguj się w wycinku Rozpowszechniania aplikacji przez Firebase. Pamiętaj, by wybrać konto Google użyte po raz pierwszy do przyjęcia zaproszenia do testowania 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 dotyczące nowych kompilacji i je instalować. Jeśli po zamknięciu i ponownym otwarciu aplikacji testerzy są proszeni o ponowne zalogowanie się, postępuj zgodnie z tymi wskazówkami, aby upewnić się, że konfiguracja Rozpowszechniania aplikacji jest poprawnie skonfigurowana:
Sprawdź, czy masz włączony interfejs Firebase App Testers API. Więcej informacji znajdziesz w artykule Włączanie App Distribution Tester API.
Sprawdź, czy w sekcji Ograniczenia kluczy interfejs Firebase App Testers API jest na liście dozwolonych interfejsów API.
Jeśli podczas wylogowywania zwykle wyczyścisz ustawienie UserDefaults, możesz wyczyścić stan testera. Rozpowszechnianie aplikacji przechowuje flagę, która wskazuje, czy 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?
Rozpowszechnianie aplikacji przez Firebase ma następujące limity testerów:
Dodawanie do projektu Firebase maksymalnie 500 testerów
Dodaj maksymalnie 200 testerów do grupy Rozpowszechniania aplikacji
Aby dodać kolejnych 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 konsoli Firebase obok wersji pojawia się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając ponownie za pomocą 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 Rozpowszechniania aplikacji, jeśli wystąpi jeden z tych warunków:
- wersja aplikacji jest starsza niż 150 dni,
- Przekraczasz limit 1000 wersji aplikacji, a wersja jest starsza niż 1000 najnowszych wersji.
Więcej informacji znajdziesz w artykule Rozpowszechnianie aplikacji obsługuje maksymalnie 1000 wersji.
Gdy aplikacja osiągnie lub przekroczy 150-dniowy okres ważności lub limit 1000 wersji, zostanie ona usunięta z panelu Rozpowszechnianie aplikacji i z aplikacji internetowej testera. Jeśli tester zainstalował wersję, wersja lokalna 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 plik IPA i usuń wersję z panelu Rozpowszechniania aplikacji. Następnie ponownie prześlij plik IPA jako nową kompilację do usługi App Distribution.
- Pobierz wersję i prześlij ją do Cloud Storage, aby wykorzystać ją do długoterminowej archiwizacji.
Wersje aplikacji wygasają po 150 dniach
Gdy prześlesz wersję aplikacji do Firebase, będzie ona widoczna w panelu Rozpowszechnianie aplikacji przez 150 dni od daty przesłania. Po przesłaniu wersji możesz ją rozpowszechnić wśród testerów, którzy zainstalują ją z aplikacji internetowej testerów Rozpowszechniania aplikacji na urządzeniu testowym.
Jeśli upłynie 30 dni od daty wygaśnięcia wersji, na stronie Rozpowszechniania aplikacji w konsoli Firebase oraz w aplikacji internetowej testera usługi App Distribution pojawi się powiadomienie o wygaśnięciu wersji aplikacji.
Rozpowszechnianie aplikacji obsługuje maksymalnie 1000 wersji.
Rozpowszechnianie aplikacji dopuszcza maksymalnie 1000 wersji na aplikację. Gdy Twoja aplikacja osiągnie limit 1000 wersji, Rozpowszechnianie aplikacji automatycznie usunie najstarsze wersje powyżej limitu.
Jeśli chcesz ręcznie zarządzać wersjami aplikacji, użyj interfejsu App Distribution API REST, aby zbiorczo wyświetlać i usuwać wersje 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 Rozpowszechnianiu aplikacji:
Zarejestruj urządzenie testowe, zbierając jego unikalny identyfikator (UDID). Jeśli testujesz dystrybucję doraźną, Firebase wysyła deweloperowi aplikacji e-maila z identyfikatorem UDID urządzenia testowego oraz instrukcjami, jak uwzględnić urządzenie w profilu udostępniania aplikacji, aby umożliwić przetestowanie kompilacji na Twoim urządzeniu.
Zainstaluj wycinek internetowy usługi 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 kompilacje, do których otrzymasz zaproszenie do testowania, są automatycznie dodawane do klipu internetowego.
Informacje o instalowaniu profili konfiguracji na urządzeniu z iOS znajdziesz w dokumentacji 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 dzięki klipowi internetowemu 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 przetestujesz aplikację.
Jeśli testujesz wersję Enterprise, 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 usługi Rozpowszechniania aplikacji i powiązane z nim dane, wykonaj te czynności:
Otwórz stronę https://appdistribution.firebase.google.com i zaloguj się na konto Google.
W prawym górnym rogu kliknij settings (Zarządzaj kontem).
Usuń konto.
Opcjonalnie: w Uprawnieniach konta Google unieważnij dostęp z funkcji Rozpowszechniania aplikacji przez Firebase. Anulowanie dostępu bez wcześniejszego usunięcia konta App Distribution nie powoduje usunięcia konta ani danych testera.