Rozwiązywanie problemów z Rozpowszechnianiem aplikacji & Najczęstsze pytania

Nie można rozpowszechniać aplikacji z powodu braku 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 App Distribution w konsoli Firebase”.

Jeśli to możliwe, ustaw kontaktowy adres e-mail w konsoli Firebase. 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 wielokrotnie wystąpią błędy 400, 409 lub 500, skontaktuj się z zespołem pomocy Firebase. Podaj zespołowi pomocy numer projektu w Firebase i identyfikator aplikacji.

Nie udało się przesłać pliku IPA

Oto 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 te czynności:

1. Sprawdź rozmiar pliku IPA. Maksymalny rozmiar wszystkich plików binarnych to 2048 MiB, czyli nieco ponad 2 GB.

2. Jeśli rozmiar pliku IPA mieści się w limicie i można go odtworzyć, wykonaj te czynności:

   1. Sprawdź plik Info.plist i potwierdź, czy CFBundleDisplayName zawiera ograniczniki <array>.

   2. Usuń ograniczniki <array> i ponownie skompiluj aplikację. Przesyłanie powinno się powieść.

   3. Jeśli problem będzie nadal występował, skontaktuj się z zespołem pomocy Firebase.

3. Jeśli rozmiar pliku IPA przekracza limit, wprowadź niezbędne zmiany, aby go zmniejszyć.

4. Jeśli zmniejszenie rozmiaru pliku IPA nie rozwiąże problemu, skontaktuj się z zespołem pomocy Firebase i zapytaj o możliwość użycia Testflight.

Tester nie ma konta Google

Gdy użytkownik tworzy konto Google, automatycznie otrzymuje adres Gmail.

Jeśli tester nie ma adresu Google Workspace ani Gmaila lub woli logować się za pomocą innego adresu e-mail, poproś go o połączenie z kontem adresu spoza Gmaila i używanie go do logowania się.

Wybierając dodatkowy adres e-mail, tester musi postępować zgodnie z tymi wytycznymi:

• Nie używaj adresu Gmail.
• Nie używaj adresu e-mail połączonego już z innym kontem Google.
• Pamiętaj, że musisz podawać hasło do konta Google, gdy logujesz się przy użyciu tego 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 zaakceptował zaproszenie e-mailowe za pomocą innego adresu e-mail niż ten, na który zostało wysłane zaproszenie, może nie widzieć odpowiednich aplikacji lub kompilacji.

Adres e-mail, na który deweloper wysyła zaproszenia i który dodaje do nowych kompilacji (adres e-mail A), może być inny niż adres e-mail, którego tester używa do zaakceptowania zaproszenia (adres e-mail B). Spowoduje to utworzenie linku w tle. Za każdym razem, gdy adres e-mail A jest dodawany do nowych kompilacji, dostęp uzyskuje adres e-mail B.

Jeśli tester zaakceptował zaproszenie e-mailowe za pomocą innego adresu e-mail, wykonaj te czynności, aby rozwiązać problem:

1. Usuń testera w sekcji Wyświetl wszystkich testerów na karcie Testerzy i grupy na stronie App Distribution w konsoli Firebase. Istniejące zaproszenia zostaną usunięte.

2. Ponownie zaproś testera do testowania aplikacji. Tester powinien otrzymać e-maila z zaproszeniem.

3. Upewnij się, że tester zaakceptuje zaproszenie, używając 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 trafiają do folderów ze spamem.

• Filtry e-maili są ustawione.

• Zaproszenie zostało wysłane na jedno konto e-mail, ale tester zaakceptował je za pomocą innego konta e-mail. Tester otrzymuje e-maile o nowych wersjach na konto e-mail, na które pierwotnie wysłano zaproszenie.

• Tester został wcześniej zaproszony, ale nie zaakceptował początkowego zaproszenia. Jeśli tester zostanie dodany do kolejnych wersji, App Distribution nie będzie automatycznie wysyłać mu powiadomień o wersjach, ponieważ nie zaakceptował on początkowego zaproszenia.

Rozwiązanie 1

1. Poproś testera o sprawdzenie folderu ze spamem i filtrów poczty ustawionych w usłudze poczty e-mail.

2. Jeśli tester zrezygnował z otrzymywania e-maili, poproś go o wykonanie tych czynności:

   1. Znajdź e-maila, którego tester otrzymał wcześniej z aplikacji.
   2. Kliknij Zarządzaj ustawieniami e-maili u dołu, a następnie Zezwalaj na e-maile, aby ponownie zasubskrybować.

Rozwiązanie 2

Jeśli tester nie chce otrzymywać e-maili z powiadomieniami i chce tylko akceptować zaproszenia do aplikacji, może wyświetlić oczekujące zaproszenia bezpośrednio w wycinku internetowym Firebase App Distribution: appdistribution.firebase.google.com.

Rozwiązanie 3

1. 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 dotychczasowych zaproszeń.

2. Ponownie zaproś testera do testowania aplikacji. Tester powinien otrzymać e-maila z zaproszeniem. Upewnij się, że tester zaakceptuje zaproszenie, używając tego samego adresu e-mail, na który zostało ono wysłane.

Błąd „Niezaufany deweloper korporacyjny” podczas próby uruchomienia aplikacji testowej

Błąd Niezaufany deweloper korporacyjny pojawia się, jeśli przed otwarciem aplikacji nie zaakceptujesz certyfikatu dewelopera na urządzeniu testowym. Na ekranie Ustawienia > Profile i zarządzanie urządzeniami wybierz nazwę dewelopera aplikacji i zaakceptuj ją.

Błąd „Wymagany tryb programisty” podczas próby uruchomienia aplikacji testowej

Błąd „Wymagany tryb programisty” pojawia się, gdy próbujesz uruchomić aplikację na iOS udostępnioną ad hoc na iOS 16 lub nowszym bez wcześniejszego włączenia trybu programisty.

Aby włączyć tryb programisty i rozwiązać ten problem, wykonaj te czynności:

1. Na iPhonie otwórz aplikację Ustawienia, a następnie kliknij Prywatność i bezpieczeństwo.
2. Przewiń w dół do sekcji Bezpieczeństwo i kliknij Tryb programisty.
3. Kliknij suwak Tryb programisty.
4. Kliknij Uruchom ponownie.
5. Po ponownym uruchomieniu odblokuj urządzenie. Pojawi się okno „Włączyć tryb programisty?”.
6. Kliknij Włącz. Możesz teraz uruchomić aplikację i rozpocząć testowanie.

"Urządzenie zarejestrowane – możesz zaczynać! Gdy aplikacja będzie gotowa do testów, otrzymasz e-maila"

Jeśli instalujesz dystrybucję ad hoc, ten komunikat pojawia 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 zainstalowanej wcześniej aplikacji testowej (lub zaakceptowanego zaproszenia), prawdopodobnie zalogowałeś(-aś) się na niewłaściwe konto Google. Aplikacje, do których masz dostęp, są powiązane z kontem Google, którego użyto podczas akceptowania zaproszenia do testowania aplikacji. Spróbuj ponownie, logując się na konto Google, którego użyto wcześniej do zaakceptowania zaproszenia.

Błąd 403: „Aby uzyskać dostęp, skontaktuj się z administratorem”

Błąd 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 uprawnienie do instalowania i testowania aplikacji, poproś administratora konta Google Workspace o zmianę ustawień konta. Administrator powinien postępować zgodnie z instrukcjami podanymi 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 konto, które nie ma ograniczeń dotyczących instalowania i testowania aplikacji.

Tester nie otrzymuje alertów w aplikacji

Jeśli masz już skonfigurowany pakiet SDK App Distribution na iOS w aplikacji, a testerzy nie otrzymują alertów w aplikacji, sprawdź, czy aplikacja pobiera nowe wersje:

1. Włącz tryb debugowania w aplikacji. Aby dowiedzieć się, jak to zrobić, zapoznaj się z dokumentacją Google Analytics.

2. Uruchom aplikację w symulatorze i wyszukaj ciąg „[Firebase/AppDistribution]”.

3. Sprawdź, czy tester ma dostęp do nowej wersji:

   • Jeśli zostanie zwrócony prawidłowy obiekt wersji, prawdopodobnie występuje problem w cyklu życia kontrolera widoku, w którym okno alertu jest wczytywane przed wyświetleniem widoku.

   • Jeśli nie zostanie zwrócona żadna wersja, tester może nie być jeszcze powiązany z nową wersją. W panelu App Distribution w konsoli Firebase sprawdź, czy tester jest uwzględniony w dystrybucji kompilacji i ma stan Zaakceptowano.

     Jeśli tester nadal nie otrzymuje aktualizacji, poproś go o skorzystanie z tych wskazówek, aby upewnić się, że zaakceptował zaproszenie do testowania aplikacji i prawidłowo skonfigurował urządzenie testowe:

     1. Na urządzeniu testowym zaloguj się w wycinku internetowym Rozpowszechniania aplikacji przez Firebase. Pamiętaj, aby wybrać konto Google, które zostało użyte po raz pierwszy, gdy zaakceptowano zaproszenie do testowania aplikacji.

     2. Upewnij się, że nowa wersja aplikacji jest dostępna w wycinku internetowym.

Po zamknięciu aplikacji tester jest proszony o ponowne zalogowanie się

Domyślnie testerzy muszą zalogować się na konto Google tylko raz, aby włączyć alerty o nowych kompilacjach i instalować nowe kompilacje. Jeśli testerzy są proszeni o ponowne zalogowanie się po zamknięciu i ponownym otwarciu aplikacji, wykonaj te czynności, aby upewnić się, że konfiguracja App Distribution jest prawidłowa:

• Sprawdź, czy interfejs Firebase App Testers API jest włączony. Więcej informacji znajdziesz w artykule Włączanie interfejsu App Distribution Tester API.

• W sekcji Ograniczenia kluczy sprawdź, czy interfejs Firebase App Testers API znajduje się na liście dozwolonych interfejsów API.

• Jeśli zwykle czyścisz UserDefaults po wylogowaniu, możesz wyczyścić stan testera. App Distribution przechowuje flagę, która wskazuje, czy tester zalogował się już w aplikacji. Więcej informacji znajdziesz w repozytorium GitHub.

Czy istnieją limity dotyczące dodawania testerów do aplikacji?

W przypadku Firebase App Distribution obowiązują te limity testerów:

• Dodaj maksymalnie 500 testerów do projektu w Firebase.

• Dodawanie maksymalnie 200 testerów do grupy App Distribution

Aby dodać więcej testerów, poproś o bezpłatne zwiększenie limitu.

Czy zaproszenia dla testerów wygasają?

Testerzy mają 30 dni na przyjęcie zaproszenia do testowania aplikacji, zanim utraci ono ważność. Gdy do wygaśnięcia zaproszenia pozostanie 5 dni, w konsoli Firebase obok testera wersji pojawi się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie za pomocą menu na wierszu testera.

Kiedy tworzona jest nowa wersja w przypadku przesyłania na iOS?

Zobacz Rejestrowanie dodatkowych urządzeń.

Jak długo wersje aplikacji są dostępne?

Wersje aplikacji są usuwane z App Distribution, jeśli wystąpi jeden z tych warunków:

• Wersja aplikacji jest starsza niż 150 dni.
• Przekroczysz limit 1000 wersji aplikacji, a wersja aplikacji jest starsza niż 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 ważności lub limit 1000 wersji, wersja zostanie usunięta z panelu App Distribution i aplikacji internetowej dla testerów App Distribution. Jeśli tester zainstalował wersję, lokalna wersja aplikacji będzie nadal działać.

Aby wersja aplikacji była dostępna dłużej, skorzystaj z jednej z tych rekomendacji:

• Zanim wersja aplikacji wygaśnie lub przekroczy limit, pobierz plik IPA i usuń wersję z panelu App Distribution. Następnie ponownie prześlij plik 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, będzie ona widoczna w panelu App Distribution przez 150 dni od daty przesłania. Po przesłaniu wersji możesz ją udostępnić testerom, którzy zainstalują ją z aplikacji internetowej App Distribution na urządzeniu testowym.

Gdy do daty ważności wersji pozostanie 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 wydań

App Distribution pozwala na maksymalnie 1000 wersji na aplikację. Gdy aplikacja osiągnie limit 1000 wersji, App Distribution automatycznie usunie najstarsze wersje powyżej limitu.

Jeśli chcesz ręcznie zarządzać wersjami aplikacji, użyj interfejsu App Distribution REST API, aby wyświetlić i usunąć wersje aplikacji zbiorczo.

Jeśli masz pytania, skontaktuj się z zespołem pomocy Firebase.

Czym jest profil Firebase?

Profil Firebase to profil konfiguracji, który umożliwia App Distribution:

• Zarejestruj urządzenie testowe, zbierając unikalny identyfikator urządzenia (UDID). Jeśli testujesz dystrybucję ad hoc, Firebase wysyła do dewelopera aplikacji e-maila z identyfikatorem UDID urządzenia testowego oraz instrukcjami, jak uwzględnić urządzenie w profilu obsługi administracyjnej aplikacji, aby można było przetestować kompilację na urządzeniu.

• Zainstaluj wycinek internetowy Firebase App Distribution na ekranie głównym urządzenia. Klip internetowy umożliwia instalowanie wszystkich aplikacji testowych i uzyskiwanie do nich dostępu w jednym miejscu. Nowe kompilacje, do których testowania Cię zaproszono, są automatycznie dodawane do klipu internetowego.

Pomoc dotyczącą instalowania 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 aplikacji testowych za pomocą wycinka 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 zainstalować profil ręcznie:

1. Zaloguj się w Google i zaakceptuj zaproszenie.

2. W sekcji Testowanie aplikacji wybierz aplikację, którą chcesz przetestować.

3. W prawym górnym rogu strony aplikacji kliknij mobile_screen_share.

4. 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 czynności:

1. Otwórz stronę https://appdistribution.firebase.google.com i zaloguj się na swoje konto Google.

2. W prawym górnym rogu kliknij settings (Zarządzaj kontem).

   Usuń konto.

3. Opcjonalnie: w uprawnieniach konta Google anuluj dostęp aplikacji Firebase App Distribution. Pamiętaj, że odebranie dostępu bez wcześniejszego usunięcia konta App Distribution nie spowoduje usunięcia konta testera ani danych.