Na tej stronie znajdziesz pomoc dotyczącą rozwiązywania problemów i odpowiedzi na najczęstsze pytania dotyczące rozpowszechniania i testowania aplikacji za pomocą App Distribution.
Rozpowszechnianie 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 rozpowszechniać aplikacji z powodu braku adresu e-mail do kontaktu
Podczas przesyłania aplikacji możesz napotkać ten błąd:
„Nie udało nam się znaleźć adresu e-mail do kontaktu z twórcą aplikacji <app-id>. Aby go skonfigurować, otwórz stronę App Distribution w konsoli Firebase.
W konsoli Firebase ustaw kontaktowy adres e-mail (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 udostępniania wielokrotnie występują 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 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 pliku binarnego to 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.plisti sprawdź, czy zawiera on jakiekolwiek rozdzielacze<array>.CFBundleDisplayNameUsuń rozdzielacze
<array>i ponownie skompiluj aplikację. Przesyłanie powinno się udać.Jeśli problemy nadal występują, 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 zespołem pomocy Firebase i zapytaj o użycie Testflight.
Instalowanie i testowanie aplikacji
Skorzystaj z tych wskazówek, aby rozwiązać problemy, które mogą napotkać testerzy podczas instalowania i testowania Twoich aplikacji.
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 zalogować się przy użyciu innego adresu e-mail, poproś go o połączenie z kontem adresu e-mail spoza Gmaila i używanie go do logowania.
Wybierając alternatywny adres e-mail, tester musi przestrzegać tych wytycznych:
- 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 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). Spowoduje to utworzenie linku w tylu. Gdy e-mail A zostaje dodany do nowych wersji, dostęp uzyskuje e-mail B.
Jeśli tester zaakceptował e-maila z zaproszeniem, korzystając z innego adresu e-mail, wykonaj te czynności, aby rozwiązać problem:
Usuń testera w sekcji Wyświetl wszystkich testerów na karcie Testerzy i grupy na stronie App Distribution konsoli Firebase. Istniejące zaproszenia zostaną usunięte.
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.
Testerzy nie otrzymują e-maili z powiadomieniami
Testerzy mogą nie otrzymywać powiadomień e-mail, jeśli wystąpi jedno z tych zdarzeń:
Powiadomienia e-mail są wysyłane do folderów spamu.
Filtry e-maili są ustawione.
Zaproszenie zostało wysłane na jeden adres e-mail, ale tester zaakceptował je z innego adresu 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ł początkowego zaproszenia. Jeśli tester zostanie dodany do kolejnych wersji, App Distribution nie będzie automatycznie wysyłać powiadomień o wersjach do tego testera, ponieważ nie zaakceptował on początkowego zaproszenia.
Rozwiązanie 1
Poproś testera o sprawdzenie folderu ze spamem i wszelkich filtrów ustawionych w usłudze poczty e-mail.
Jeśli tester anulował subskrypcję e-maili, poproś go o wykonanie tych czynności:
- Znajdź e-maila, który tester otrzymał wcześniej od aplikacji.
- Aby ponownie zasubskrybować kanał, u dołu kliknij Zarządzaj ustawieniami poczty e-mail, a potem kliknij Zezwalaj na wysyłanie e-maili.
Rozwiązanie 2
Jeśli tester nie chce otrzymywać powiadomień e-mail i chce tylko akceptować zaproszenia do aplikacji, może wyświetlić oczekujące zaproszenia do aplikacji bezpośrednio w klipie internetowym Firebase App Distribution: appdistribution.firebase.google.com.
Rozwiązanie 3
Usuń testera z sekcji Wyświetlanie 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
Błąd Nieuczciwy deweloper korporacyjny pojawia się, jeśli przed otwarciem aplikacji nie zaufasz certyfikatowi dewelopera na urządzeniu testowym. Na ekranie Ustawienia > Profile i zarządzanie urządzeniami wybierz nazwę dewelopera aplikacji i mu zaufaj.
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 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:
- Na iPhonie otwórz aplikację Ustawienia i kliknij Prywatność i ochrona.
- Przewiń w dół do sekcji Bezpieczeństwo i kliknij Tryb programisty.
- Kliknij suwak Tryb programisty.
- Kliknij Uruchom ponownie.
- Po ponownym uruchomieniu urządzenia odblokuj je. Pojawi się okno „Włącz tryb programisty?”.
- Kliknij Włącz. Możesz teraz uruchomić aplikację i rozpocząć testowanie.
„Urządzenie zarejestrowane – wszystko gotowe. Gdy aplikacja będzie gotowa do testów, otrzymasz e-maila.
Jeśli instalujesz wersję Ad Hoc, ten komunikat pojawi 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 Rejestracja 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 do której zaakceptowano zaproszenie), prawdopodobnie zalogowano Cię 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 uprawnienie do instalowania i testowania aplikacji, poproś administratora konta Google Workspace o zmianę ustawień konta. Administrator powinien wykonać instrukcje podane 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, na którym nie obowiązują ograniczenia dotyczące instalowania i testowania aplikacji.
Włączanie alertów w aplikacji za pomocą pakietu App Distribution iOS SDK
Aby rozwiązać problemy związane z włączaniem alertów o nowej wersji aplikacji za pomocą pakietu SDK na iOS App Distribution, skorzystaj z podanych niżej wskazówek.
Testerzy nie otrzymują powiadomień 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 aplikacji. Więcej informacji znajdziesz w dokumentacji Google Analytics.
Uruchom aplikację w symulatorze i poszukaj ciągu „[Firebase/AppDistribution]”.
Sprawdź, czy tester ma dostęp do nowej wersji:
Jeśli zwrócony zostanie prawidłowy obiekt release, prawdopodobnie wystąpił problem z cyklem życia kontrolera widoku, w którym okno alertu jest ładowane przed wyświetleniem widoku.
Jeśli nie zostanie zwrócona żadna wersja, testujący może nie być jeszcze powiązany z 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 przestrzeganie tych wskazówek, aby upewnić się, że zaakceptował zaproszenie do testowania aplikacji i prawidłowo skonfigurował urządzenie testowe:
Na urządzeniu testowym zaloguj się w aplikacji internetowej Firebase App Distribution. Pamiętaj, aby wybrać konto Google, którego użyto podczas akceptacji zaproszenia do przetestowania aplikacji.
Upewnij się, że nowa wersja aplikacji jest dostępna w klipie internetowym.
po zamknięciu aplikacji testerowi wyświetla się prośba o ponowne zalogowanie się.
Domyślnie testerzy muszą zalogować się na swoje konto Google tylko raz, aby włączyć alerty dotyczące nowych wersji i zainstalować nowe wersje. Jeśli po zamknięciu i ponowym otwarciu aplikacji testerzy otrzymują prośbę o ponowne zalogowanie, wykonaj te czynności, aby sprawdzić, czy konfiguracja App Distribution jest prawidłowo skonfigurowana:
Sprawdź, czy masz włączony interfejs API Testerzy aplikacji Firebase. Więcej informacji znajdziesz w artykule Włączanie interfejsu App Distribution Tester API.
W sekcji Ograniczenia klucza sprawdź, czy interfejs API Testerzy aplikacji Firebase znajduje się na liście dozwolonych interfejsów API.
Jeśli zwykle przy wylogowywanie usuwasz UserDefaults, możesz w ten sposób usuwać stan testera. App Distribution przechowuje flagę wskazującą, czy Twój tester zalogował się już w aplikacji. Więcej informacji znajdziesz w repozytorium GitHub.
Najczęstsze pytania
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 Firebase
Do grupy App Distribution możesz dodać maksymalnie 200 testerów
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 przetestowania aplikacji, zanim utraci ono ważność. Gdy do wygaśnięcia zaproszenia pozostanie 5 dni, w konsoli Firebase obok testera w ramach 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łań na iOS?
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 wydań.
Gdy aplikacja osiągnie lub przekroczy limit 150 dni lub limit 1000 wersji, zostanie usunięta z poziomu App Distribution w panelu oraz z App Distribution w aplikacji internetowej dla testerów. Jeśli tester zainstalował wersję, lokalna wersja aplikacji będzie nadal działać.
Aby wersja aplikacji była dostępna dłużej, zastosuj jedną z tych rekomendacji:
- Zanim wersja aplikacji wygaśnie lub przekroczy limit wersji, pobierz plik 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, aby przechowywać ją przez długi czas.
Wersje aplikacji wygasają po 150 dniach
Gdy prześlesz wersję aplikacji do Firebase, pojawi się ona na stronie App Distribution 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 poziomu App Distributionaplikacji internetowej dla testerów na swoim urządzeniu testowym.
Gdy do daty wygaśnięcia pozostało 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 wersji
App Distribution pozwala na maksymalnie 1000 wersji aplikacji. Gdy aplikacja osiągnie limit 1000 wersji, App Distribution automatycznie usunie najstarsze wersje, które przekroczyły ten 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.
Czym jest profil Firebase?
Profil Firebase to profil konfiguracji, który umożliwia App Distribution:
Zarejestruj urządzenie testowe, zbierając jego unikalny identyfikator urządzenia (UDID). Jeśli testujesz rozpowszechnianie Ad Hoc, Firebase wysyła do dewelopera e-maila z identyfikatorem UDID urządzenia testowego oraz instrukcjami dodania urządzenia do profilu zarzadzania aplikacją, aby można było przetestować wersję na urządzeniu.
Zainstaluj klip internetowy Firebase App Distribution na ekranie głównym urządzenia. Dzięki klipowi internetowemu możesz instalować wszystkie aplikacje testowe i dostęp do nich uzyskać w jednym miejscu. Nowe wersje, które możesz testować, są automatycznie dodawane 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 moim urządzeniu?
Jeśli jesteś testerem, możesz uzyskać dostęp do wszystkich swoich aplikacji testowych za pomocą klipu internetowego Firebase App Distribution, który jest automatycznie dodawany do ekranu głównego testowanego urządzenia 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ę wersji Enterprise, możesz ręcznie zainstalować profil:
Zaloguj się w Google i zaakceptuj zaproszenie.
W sekcji Testuj aplikacje wybierz aplikację, którą chcesz przetestować.
W prawym górnym rogu strony aplikacji kliknij mobile_screen_share.
Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby zainstalować profil Firebase.
Jak usunąć konto testera?
Aby usunąć konto testowe App Distribution i powiązane z nim dane, wykonaj te czynności w kolejnoś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 cofnij dostęp do aplikacji Firebase App Distribution. Pamiętaj, że cofnięcie dostępu bez wcześniejszego usunięcia konta App Distribution nie powoduje usunięcia danych ani konta testera.