Ta strona zawiera pomoc w rozwiązywaniu problemów i odpowiedzi na często zadawane pytania dotyczące dystrybucji i testowania aplikacji za pomocą usługi App Distribution.
Dystrybucja aplikacji
Skorzystaj z poniższych wskazówek, aby rozwiązać problemy, które mogą wystąpić podczas dystrybucji aplikacji do testerów.
Podczas przesyłania aplikacji może wystąpić ten błąd:
„Nie mogliśmy znaleźć kontaktowego adresu e-mail dla aplikacji <app-id>
. Odwiedź sekcję Dystrybucja aplikacji w konsoli Firebase, aby ją skonfigurować”.
Ustaw kontaktowy adres e-mail w konsoli Firebase, jeśli jest dostępny. Jeśli problem będzie się powtarzał, skontaktuj się z pomocą techniczną Firebase .
Jeśli podczas obsługi administracyjnej wielokrotnie napotykasz błędy 400, 409 lub 500, skontaktuj się z pomocą techniczną Firebase . Podaj numer projektu Firebase i identyfikator aplikacji.
Sprawdź rozmiar pliku APK. Maksymalny limit rozmiaru pliku dla wszystkich plików binarnych to 2048 MiB, czyli nieco ponad 2 GB.
Jeśli rozmiar pliku APK mieści się w limicie rozmiaru pliku i można go odtworzyć, skontaktuj się z pomocą techniczną Firebase .
Sprawdź, czy plik APK jest podpisany przy użyciu:
apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk
Dystrybucja pakietów aplikacji na Androida (AAB)
Gdy przesyłasz plik AAB do dystrybucji aplikacji, Google Play automatycznie rezygnuje z wygenerowanego pliku APK przy użyciu certyfikatu klucza podpisywania aplikacji testowej. Po wyświetleniu monitu musisz zarejestrować swoją aplikację u dostawców interfejsów API, jeśli chcesz nadal korzystać z ich usług innych firm. Po podpisaniu certyfikat testowy aplikacji można wyświetlić w konsoli Firebase.
Kompilacje AAB, które przesyłasz do dystrybucji aplikacji, nie pojawiają się na Twoim koncie programisty Google Play (dotyczy to Eksploratora pakietu aplikacji i wewnętrznego udostępniania aplikacji).
Jeśli aplikacja Firebase na Androida zostanie odłączona od Google Play, dzieje się tak:
Nie będzie można przesyłać nowych pakietów aplikacji do usługi App Distribution ani eksportować ich do Google Play za pośrednictwem integracji usługi App Distribution z Google Play.
Istniejące kompilacje będą nadal dostępne w panelu Firebase App Distribution i dla Twoich testerów.
Wszelkie dane wcześniej wyeksportowane między Firebase a Google Play pozostaną dostępne w obu usługach.
Aby dystrybuować pakiet aplikacji na Androida (AAB) za pośrednictwem dystrybucji aplikacji i automatycznie łączyć przesłane pakiety AAB zarówno z projektem Firebase, jak i kontem programisty Google Play, upewnij się, że spełniasz następujące wymagania:
Twoje konto programisty Google Play ma jeden z następujących poziomów dostępu : właściciel lub administrator.
W projekcie Firebase masz jedną z następujących ról: Właściciel lub Administrator Firebase .
Twoja aplikacja jest zarejestrowana w Firebase i na Twoim koncie programisty Google Play. Oznacza to, że masz zarówno aplikację Firebase na Androida, jak i aplikację Google Play.
Aplikacja w Google Play i aplikacja Firebase na Androida są zarejestrowane przy użyciu tej samej nazwy pakietu.
Aplikacja w Google Play jest konfigurowana na pulpicie nawigacyjnym aplikacji i jest dystrybuowana do jednej ze ścieżek Google Play (testy wewnętrzne, testy zamknięte, testy otwarte lub produkcja).
Recenzja aplikacji w Google Play została zakończona i aplikacja została opublikowana. Twoja aplikacja jest opublikowana, jeśli w kolumnie Stan aplikacji wyświetlany jest jeden z następujących stanów: Testy wewnętrzne (nie Wersja robocza testów wewnętrznych), Testy zamknięte, Testy otwarte lub Produkcja.
Jeśli przesłana przez Ciebie aplikacja, która wcześniej nie spełniała powyższych kryteriów łączenia, a teraz spełnia, możesz ponownie spróbować połączyć swoją aplikację Firebase na Androida z Google Play .
Instalowanie i testowanie aplikacji
Skorzystaj z poniższych wskazówek, aby rozwiązać problemy, które testerzy mogą napotkać podczas instalowania i testowania aplikacji.
Gdy użytkownik tworzy konto Google, automatycznie otrzymuje adres Gmail.
Jeśli tester nie ma adresu Google Workspace ani adresu Gmail albo woli użyć innego adresu e-mail do zalogowania się, poproś testera o powiązanie z kontem adresu e-mail innego niż Gmail i zalogowanie się przy użyciu tego adresu e-mail.
Wybierając alternatywny adres e-mail, tester musi przestrzegać następujących 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 użyć hasła do konta Google podczas logowania za pomocą tego adresu e-mail.
Aby uzyskać więcej informacji, zobacz Logowanie się na konto Google przy użyciu innego adresu e-mail .
Jeśli tester zaakceptował zaproszenie e-mail z innym adresem e-mail niż ten, na który zostało wysłane zaproszenie, tester może nie widzieć odpowiednich aplikacji lub kompilacji.
Adres e-mail, na który programista wysyła zaproszenia i które dodaje do nowych kompilacji (e-mail A), może różnić się od adresu e-mail, którego używa tester do zaakceptowania zaproszenia (e-mail B). To tworzy link za kulisami. Ilekroć e-mail A jest dodawany do nowych kompilacji, w rzeczywistości dostęp uzyskuje e-mail B.
Jeśli tester zaakceptował zaproszenie e-mail z innym adresem e-mail, wykonaj następujące czynności, aby rozwiązać problem:
Usuń testera z karty Testerzy i grupy na stronie Dystrybucja aplikacji w konsoli Firebase. Istniejące zaproszenia zostaną usunięte.
Ponownie zaproś testera do przetestowania Twojej aplikacji. Tester powinien otrzymać wiadomość e-mail z zaproszeniem.
Upewnij się, że tester akceptuje zaproszenie z tym samym adresem e-mail.
Testerzy mogą nie otrzymywać powiadomień e-mail, jeśli wystąpi jedna z poniższych sytuacji:
Powiadomienia e-mail są wysyłane 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 wiadomości e-mail z nowymi wersjami dla konta e-mail, na które pierwotnie wysłano zaproszenie.
Tester został wcześniej zaproszony, ale nie przyjął pierwszego zaproszenia. Jeśli tester zostanie dodany do kolejnych wersji, usługa App Distribution nie będzie automatycznie wysyłać powiadomień o wydaniach do tego testera, ponieważ tester nie zaakceptował początkowego zaproszenia.
Rozwiązanie 1
Poproś testera o sprawdzenie folderu ze spamem i wszelkich filtrów e-mail ustawionych w jego usłudze e-mail.
Jeśli tester anulował subskrypcję e-maili, poproś testera o wykonanie następujących czynności:
- Znajdź wiadomość e-mail, którą tester otrzymał wcześniej z aplikacji.
- Kliknij Zarządzaj ustawieniami poczty e-mail u dołu i kliknij Zezwalaj na ponowną subskrypcję e-maili .
Rozwiązanie 2
Usuń testera z karty Testerzy i grupy na stronie Dystrybucja aplikacji w konsoli Firebase. Ta czynność usuwa istniejące zaproszenia.
Ponownie zaproś testera do przetestowania Twojej aplikacji. Tester powinien otrzymać wiadomość e-mail z zaproszeniem. Upewnij się, że tester akceptuje zaproszenie z tym samym adresem e-mail, na który zostało wysłane zaproszenie.
Jeśli tester pobierze i zainstaluje wersję, ale interfejs użytkownika szczegółów aplikacji nie pokazuje, że aplikacja jest zainstalowana, jest to znany problem. W niektórych przypadkach identyfikator pakietu w aplikacji Firebase nie pasuje do identyfikatora pakietu APK.
Sprawdź, czy identyfikator pakietu APK jest zgodny z identyfikatorem pakietu aplikacji Firebase użytej do przesłania dystrybucji.
Alert Androida pojawia się, jeśli uruchomiona aplikacja lub przeglądarka nie otrzymała jeszcze pozwolenia na instalowanie aplikacji spoza Google Play. Aby udzielić pozwolenia:
Android w wersji 8 lub nowszej : w aplikacji Ustawienia kliknij Zezwól z tego źródła .
Android w wersji 7 lub starszej : w aplikacji Ustawienia dotknij Zabezpieczenia i wybierz Nieznane źródła . Gdy pojawi się monit, dotknij OK > Zaufaj .
Jeśli testowego pakietu APK nie można zainstalować na urządzeniu testera:
- Sprawdź, czy certyfikat(y) w nowej wersji są zgodne z wersją zainstalowaną na urządzeniu testera. System Android umożliwia aktualizację aplikacji tylko wtedy, gdy certyfikaty są zgodne. Aby dowiedzieć się więcej, zobacz Uwagi dotyczące podpisywania .
- Upewnij się, że aplikacja obsługuje wersję systemu operacyjnego testera (sprawdź
minSdkVersion
).
Jeśli aplikacja App Tester uniemożliwia Ci zalogowanie się i przekierowuje z powrotem do ekranu logowania, być może korzystasz z Google Workspace (dawniej GSuite), który zawiera ustawienia ograniczeń.
Aby usunąć ustawienia ograniczeń:
Na karcie Aplikacje w Google Workspace upewnij się, że Dystrybucja aplikacji Firebase nie jest ustawiona na Dostęp: zablokowany .
Na karcie Usługi upewnij się, że usługa Cloud Platform jest nieograniczona.
Po usunięciu ustawień spróbuj zalogować się ponownie.
Ten błąd może wystąpić, gdy instalowana aplikacja powoduje konflikt z aplikacją już zainstalowaną na urządzeniu. Może to być na przykład inny wariant tej samej aplikacji z tym samym niestandardowym uprawnieniem lub nazwą ContentProvider .
Możesz poprosić testera o zebranie raportu o błędzie natychmiast po wystąpieniu problemu i przejrzenie raportu, aby uzyskać więcej informacji o przyczynie. Tester musi usunąć wszelkie aplikacje powodujące konflikt, zanim będzie można zainstalować nową aplikację.
Gdy napotkasz 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 powinieneś mieć uprawnienia do 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 są kontrolowane indywidualnie .
Jeśli masz wiele kont, spróbuj zalogować się przy użyciu innego konta, które nie ma ograniczeń dotyczących instalowania i testowania aplikacji.
Włączanie alertów w aplikacji za pomocą zestawu Android SDK do dystrybucji aplikacji
Skorzystaj z poniższych wskazówek, aby rozwiązać problemy związane z włączaniem alertów o nowych kompilacjach w aplikacji przy użyciu zestawu Android SDK do dystrybucji aplikacji.
Jeśli masz już skonfigurowany pakiet App Distribution Android SDK w swojej aplikacji, a Twoi testerzy nie otrzymują alertów w aplikacji, wykonaj następujące kroki:
Sprawdź komunikaty o błędach, dołączając
OnFailureListener
do zadania zwróconego przez interfejs Firebase App Distribution API.Jawa
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> { if (e instanceof FirebaseAppDistributionException) { // Log exception here }});
Kotlin
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e -> if (e is FirebaseAppDistributionException) { // Log exception here } }
Sprawdź, czy tester ma dostęp do nowej wersji:
Włącz tryb debugowania w swojej aplikacji. Aby dowiedzieć się, jak to zrobić, zapoznaj się z dokumentacją Google Analytics .
Uruchom aplikację w symulatorze i wyszukaj ciąg „FirebaseAppDistribution”.
Jeśli dzienniki wskazują, że nie znaleziono żadnej wersji lub że tester nie ma dostępu, tester może nie być jeszcze powiązany z nową wersją.
Na pulpicie nawigacyjnym Dystrybucja aplikacji w konsoli Firebase upewnij się, że tester jest uwzględniony w Twojej dystrybucji kompilacji i ma stan Zaakceptowany .
Jeśli tester nadal nie otrzymuje alertów, poproś go o wykonanie poniższych wskazówek, aby upewnić się, że zaakceptował zaproszenie do przetestowania Twojej aplikacji i prawidłowo skonfigurował swoje urządzenie testowe:
Na urządzeniu testowym zaloguj się do usługi Firebase App Distribution za pomocą testera aplikacji lub aplikacji internetowej testera. Pamiętaj, aby wybrać konto Google użyte po raz pierwszy, kiedy zaakceptowałeś zaproszenie do przetestowania aplikacji.
Sprawdź, czy nowa wersja aplikacji jest dostępna w Testerze aplikacji lub w aplikacji internetowej testera.
Domyślnie Twoi testerzy muszą tylko raz zalogować się na swoje konto Google, aby włączyć nowe aktualizacje kompilacji i zainstalować nowe kompilacje. Jeśli testerzy są proszeni o ponowne zalogowanie się po zamknięciu i ponownym otwarciu aplikacji, postępuj zgodnie z tymi wskazówkami, aby upewnić się, że konfiguracja dystrybucji aplikacji jest prawidłowo skonfigurowana:
Sprawdź, czy masz włączony interfejs Firebase App Testers API. Aby uzyskać więcej informacji, zobacz Włączanie interfejsu API testera dystrybucji aplikacji .
W obszarze Kluczowe ograniczenia upewnij się, że interfejs Firebase App Testers API znajduje się na liście dozwolonych interfejsów API.
Jeśli zazwyczaj czyścisz SharedPreferences przy wylogowaniu, być może czyścisz stan swojego testera. Dystrybucja aplikacji przechowuje flagę wskazującą, czy tester zalogował się już do aplikacji. Aby uzyskać więcej informacji, zobacz repozytorium GitHub .
Często Zadawane Pytania
Dystrybucja aplikacji Firebase ma następujące limity testerów:
Dodaj maksymalnie 500 testerów do projektu Firebase
Dodaj maksymalnie 200 testerów do grupy dystrybucji aplikacji
Aby dodać więcej testerów, poproś o bezpłatne zwiększenie limitu .
Testerzy mają 30 dni na zaakceptowanie zaproszenia do przetestowania aplikacji przed jego wygaśnięciem. Gdy zaproszenie wygaśnie za 5 dni, w konsoli Firebase obok testera pojawi się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie za pomocą menu rozwijanego w wierszu testera.
Wersje aplikacji są usuwane z usługi Dystrybucja aplikacji, jeśli spełniony jest jeden z następujących warunków:
- Wersja aplikacji jest starsza niż 150 dni.
- Przekraczasz limit 1000 wersji aplikacji, a wersja aplikacji jest starsza niż 1000 najnowszych wersji aplikacji.
Aby uzyskać więcej informacji, zobacz Dystrybucja aplikacji obsługuje maksymalnie 1000 wydań .
Gdy aplikacja osiągnie lub przekroczy 150-dniowy limit wygaśnięcia lub limit 1000 wersji, wersja zostanie usunięta z pulpitu dystrybucji aplikacji i aplikacji Firebase App Tester. Jeśli tester zainstalował tę wersję, lokalna wersja aplikacji nadal działa.
Aby wersja aplikacji była dłużej dostępna, skorzystaj z jednej z poniższych rekomendacji:
- Zanim wersja aplikacji wygaśnie lub przekroczy limit wersji, pobierz plik APK lub AAB i usuń wersję z pulpitu dystrybucji aplikacji. Następnie ponownie prześlij plik APK lub AAB jako nową kompilację do dystrybucji aplikacji.
- Pobierz wersję i prześlij ją do Cloud Storage w celu długoterminowej archiwizacji.
Wersje aplikacji wygasają po 150 dniach
Gdy prześlesz wersję swojej aplikacji do Firebase, pojawi się ona w panelu dystrybucji aplikacji przez 150 dni, licząc od daty przesłania. Po przesłaniu wersji możesz ją rozesłać do testerów, którzy zainstalują ją z aplikacji Firebase App Tester na swoim urządzeniu testowym.
Gdy upłynie 30 dni od daty wygaśnięcia wersji, na Twojej wersji w aplikacji Firebase App Tester pojawi się powiadomienie o wygaśnięciu wersji.
Dystrybucja aplikacji obsługuje maksymalnie 1000 wydań
Dystrybucja aplikacji zezwala na maksymalnie 1000 wydań na aplikację. Kiedy Twoja aplikacja osiągnie limit 1000 wydań aplikacji, Dystrybucja aplikacji automatycznie usunie najstarsze wydania przekraczające ten limit.
Jeśli chcesz ręcznie zarządzać wersjami aplikacji, użyj interfejsu API REST dystrybucji aplikacji, aby zbiorczo wyświetlać i usuwać wersje aplikacji.
Jeśli masz pytania, skontaktuj się z pomocą techniczną Firebase .
Jeśli jesteś testerem, zalecamy pobranie Firebase App Tester , aplikacji, która umożliwia dostęp do wszystkich kompilacji testowych w jednym miejscu.
Aby usunąć konto testera dystrybucji aplikacji i powiązane z nim dane, wykonaj następujące kroki w podanej kolejności:
Odwiedź https://appdistribution.firebase.google.com i zaloguj się na swoje konto Google.
W prawym górnym rogu kliknij
( Zarządzaj kontem )Usuń konto .
Opcjonalnie: w uprawnieniach swojego konta Google anuluj dostęp Firebase App Distribution. Pamiętaj, że cofnięcie dostępu bez uprzedniego usunięcia konta App Distribution nie powoduje usunięcia konta ani danych testera.