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źć adresu e-mail do kontaktu w sprawie aplikacji <app-id>. Aby ją skonfigurować, otwórz stronę App Distribution w konsoli Firebase”.

W razie potrzeby ustaw adres e-mail do kontaktu w konsoli Firebase. Jeśli problem będzie nadal występował, skontaktuj się z zespołem pomocy Firebase.

Podczas udostępniania aplikacji wystąpił błąd (kody błędów 400, 409 lub 500)

Jeśli podczas udostępniania wielokrotnie napotykasz 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 rozmiaru pliku i można go odtworzyć, wykonaj te czynności:

   1. Sprawdź plik Info.plist i upewnij się, czy CFBundleDisplayName zawiera jakieś ograniczniki <array>.

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

   3. Jeśli nadal masz problemy, 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ść korzystania z Testflight.

Tester nie ma konta Google

Gdy użytkownik utworzy konto Google, automatycznie otrzyma adres Gmail.

Jeśli tester nie ma adresu Google Workspace ani Gmail lub woli logować się za pomocą innego adresu e-mail, poproś go o połączenie ze swoim 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 e-mail.

Więcej informacji znajdziesz w artykule Logowanie się na konto Google przy użyciu innego adresu e-mail.

Tester nie widzi właściwych aplikacji ani kompilacji

Jeśli tester zaakceptuje zaproszenie e-mail za pomocą innego adresu e-mail niż ten, na który zostało wysłane zaproszenie, może nie widzieć odpowiednich aplikacji lub wersji.

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

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

1. Usuń testera z 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 przy użyciu tego samego adresu e-mail.

Tester nie otrzymuje e-maili z powiadomieniami

Testerzy mogą nie otrzymywać powiadomień e-mail w tych przypadkach:

• E-maile z powiadomieniami są wysyłane do folderów spamu.

• Filtry e-maili są ustawione.

• Zaproszenie zostało wysłane na jedno konto e-mail, ale tester zaakceptował je na innym koncie e-mail. Tester otrzymuje e-maile o nowych wersjach na konto e-mail, na które zostało wysłane zaproszenie.

• Tester został wcześniej zaproszony, ale nie zaakceptował początkowego zaproszenia. Jeśli tester zostanie dodany do kolejnych wersji, App Distribution nie wyśle mu automatycznie powiadomień o wersji, ponieważ nie zaakceptował on początkowego zaproszenia.

Rozwiązanie 1

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

2. Jeśli tester anulował subskrypcję e-maili, poproś go o wykonanie tych czynności:

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

Rozwiązanie 2

Jeśli tester nie chce otrzymywać powiadomień e-mail, a zależy mu tylko na możliwości akceptowania zaproszeń do aplikacji, może wyświetlić oczekujące zaproszenia do aplikacji bezpośrednio w Firebase App Distributionklipie internetowym:appdistribution.firebase.google.com.

Rozwiązanie 3

1. Usuń testera z 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ń.

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

Błąd „Untrusted Enterprise Developer” podczas próby uruchomienia aplikacji testowej

Błąd Untrusted Enterprise Developer (Niezaufany deweloper korporacyjny) pojawia się, jeśli przed otwarciem aplikacji nie potwierdzisz certyfikatu dewelopera na urządzeniu testowym. Na ekranie Ustawienia > Profile i zarządzanie urządzeniami wybierz nazwę dewelopera aplikacji i potwierdź ją.

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

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

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

1. Na iPhonie otwórz aplikację Ustawienia i kliknij Prywatność i ochrona.
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 urządzenia odblokuj je. Pojawi się okno dialogowe 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 aplikację w ramach dystrybucji ad hoc, ten komunikat pojawi się, gdy deweloper nie skonfiguruje jeszcze aplikacji do działania na Twoim urządzeniu testowym. Aby udostępnić Ci aplikację, deweloper musi wykonać instrukcje podane w artykule 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 zainstalowano (lub w przypadku której zaakceptowano zaproszenie), prawdopodobnie zalogowano 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 pierwszego zaakceptowania zaproszenia do testowania aplikacji. Spróbuj jeszcze raz, 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”

Jeśli pojawi się błąd 403, oznacza to, że konto, którego używasz, nie ma uprawnień do instalowania i testowania aplikacji. Dostęp zależy od administratora domeny konta w Google Workspace.

Jeśli uważasz, że powinna Ci przysługiwać możliwość 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 App Distributionpakiet SDK 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 znaków „[Firebase/AppDistribution]”.

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

   • Jeśli zostanie zwrócony prawidłowy obiekt wersji, prawdopodobnie wystąpił problem w cyklu życia kontrolera widoku, w którym okno alertu zostało wczytane przed pojawieniem się widoku.

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

     Jeśli tester nadal nie otrzymuje aktualizacji, poproś go o wykonanie poniższych czynności, aby upewnić się, że zaakceptował zaproszenie do testowania aplikacji i prawidłowo skonfigurował urządzenie testowe:

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

     2. Sprawdź, czy nowa wersja aplikacji jest dostępna w klipie internetowym.

Tester jest proszony o ponowne zalogowanie się po zamknięciu aplikacji

Domyślnie testerzy muszą zalogować się na konto Google tylko raz, aby włączyć alerty o nowych wersjach i je zainstalować. Jeśli po zamknięciu i ponownym otwarciu aplikacji testerzy są proszeni o ponowne zalogowanie się, skorzystaj z tych wskazówek, aby upewnić się, że konfiguracja App Distribution jest prawidłowa:

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

• W sekcji Ograniczenia klucza 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?

Firebase App Distribution ma te limity testerów:

• Dodawanie maksymalnie 500 testerów do projektu w Firebase

• Dodaj 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 zaakceptowanie zaproszenia do testowania aplikacji, zanim utraci ono ważność. Gdy zaproszenie będzie wygasać za 5 dni, w konsoli Firebase obok testera w wersji pojawi się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie z menu w wierszu testera.

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

Zobacz Rejestrowanie dodatkowych urządzeń.

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ż 1000 najnowszych wersji.

Więcej informacji znajdziesz w artykule App Distribution obsługuje maksymalnie 1000 wersji.

Gdy aplikacja osiągnie lub przekroczy 150-dniowy limit ważności lub limit 1000 wersji aplikacji, zostanie usunięta z App DistributionpaneluApp Distribution i z aplikacji internetowej dla testerów. Jeśli tester zainstalował wersję, lokalna wersja aplikacji będzie nadal działać.

Aby dłużej utrzymać dostępność wersji aplikacji, 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ługoterminowego archiwizowania.

Wersje aplikacji wygasają po 150 dniach

Gdy prześlesz wersję aplikacji do Firebase, będzie ona widoczna na App Distribution panelu przez 150 dni od daty przesłania. Po przesłaniu wersji możesz ją udostępnić testerom, którzy zainstalują ją z App Distributionaplikacji internetowej dla testerów na urządzeniu testowym.

Gdy do daty wygaśnięcia wersji pozostanie 30 dni, w App Distribution konsoli na stronie Firebase oraz w App Distribution aplikacji internetowej dla testerów pojawi się powiadomienie o wygaśnięciu wersji aplikacji.

App Distribution obsługuje maksymalnie 1000 wersji.

App Distribution umożliwia opublikowanie maksymalnie 1000 wersji aplikacji. Gdy osiągniesz ten limit, App Distribution automatycznie usunie najstarsze wersje powyżej limitu.

Jeśli chcesz ręcznie zarządzać wersjami aplikacji, użyj interfejsu App DistributionREST API, aby wyświetlać i usuwać 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żliwiaApp Distribution:

• Zarejestruj urządzenie testowe, zbierając jego niepowtarzalny identyfikator (UDID). Jeśli testujesz dystrybucję Ad Hoc, Firebase wysyła do dewelopera aplikacji e-maila z identyfikatorem UDID urządzenia testowego oraz instrukcjami, jak dodać urządzenie do profilu aprowizacji aplikacji, aby można było testować kompilację na urządzeniu.

• Zainstaluj klip 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 wersje, które możesz przetestować, są automatycznie dodawane do klipu internetowego.

Aby uzyskać pomoc dotyczącą instalowania profili konfiguracji 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 aplikacji testowych za pomocą Firebase App Distributionklipu internetowego, 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ędziesz mieć możliwość przetestowania aplikacji.

Jeśli testujesz dystrybucję w wersji Enterprise, możesz ręcznie zainstalować profil:

1. Zaloguj się w Google i zaakceptuj zaproszenie.

2. W sekcji Aplikacje do testowania wybierz aplikację, którą chcesz przetestować.

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

4. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby zainstalować profil Firebase.

Jak usunąć konto testera?

Aby usunąć App Distribution konto testera i powiązane z nim dane, wykonaj te czynności w podanej kolejności:

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

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

   Kliknij Usuń konto.

3. Opcjonalnie: w sekcji Uprawnienia konta Google cofnij dostęp, klikając Firebase App Distribution. Pamiętaj, że cofnięcie dostępu bez wcześniejszego usunięcia konta App Distribution nie powoduje usunięcia konta testera ani danych.