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 Firebasekonsoli".

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 (błędy 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 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 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 jakiekolwiek ograniczniki <array>.

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

   3. Jeśli problemy nadal występują, 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 Gmail lub woli używać innego adresu e-mail do logowania się, poproś go o powiązanie z kontem adresu e-mail innego niż Gmail i używanie go do logowania się.

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

• 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.

Tester nie widzi właściwych aplikacji ani kompilacji

Jeśli tester zaakceptuje zaproszenie e-mail przy użyciu 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 Firebasekonsoli. 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-maila, które ustawił w swojej usłudze poczty elektronicznej.

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 ponownie zasubskrybować.

Rozwiązanie 2

Jeśli tester nie chce otrzymywać powiadomień e-mail i chce tylko móc akceptować zaproszenia 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.

Błąd „Untrusted Enterprise Developer” (Niezaufany deweloper korporacyjny) podczas próby uruchomienia aplikacji testowej

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

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

Błąd „Developer Mode Required” (Wymagany tryb dewelopera) pojawia się, gdy próbujesz uruchomić aplikację na iOS w trybie ad hoc na urządzeniu z iOS 16 lub nowszym 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, a następnie 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 jest określany przez 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 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 App Distributionpakiet SDK na iOS jest już skonfigurowany w aplikacji, a testerzy nie otrzymują alertów w aplikacji, sprawdź, czy aplikacja pobiera nowe wersje:

1. Włącz tryb debugowania w aplikacji. Instrukcje znajdziesz w dokumentacji 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 zwracany jest prawidłowy obiekt wersji, prawdopodobnie występuje problem w cyklu życia kontrolera widoku, 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ą. Na panelu App Distribution w 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 Firebase App Distribution. Pamiętaj, aby wybrać konto Google, którego użyto po raz pierwszy, gdy zaakceptowano zaproszenie do testowania aplikacji.

     2. Upewnij się, że 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 zainstalować nowe wersje. 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 App Distribution konfiguracja 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 mojej aplikacji?

Firebase App Distribution ma te limity testerów:

• Dodawanie maksymalnie 500 testerów do projektu 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 za pomocą 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, wersja zostanie usunięta z App Distribution panelu i App Distribution 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 wygaśnie wersja aplikacji lub przekroczy limit wydań, 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ą na urządzeniu testowym z App Distributionaplikacji internetowej dla testerów.

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

App Distribution obsługuje maksymalnie 1000 wersji.

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

Jeśli chcesz ręcznie zarządzać wersjami aplikacji, użyj App Distributioninterfejsu API REST, 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żliwia App Distribution:

• Zarejestruj urządzenie testowe, zbierając jego unikalny 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, do których testowania otrzymasz zaproszenie, 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 swoich 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, przed rozpoczęciem testowania aplikacji musisz najpierw zainstalować profil.

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 testowe wybierz aplikację, którą chcesz testować.

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 Distributionkonto 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).

   Usuń konto.

3. Opcjonalnie: w uprawnieniach 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.