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 APK
Sprawdź rozmiar pliku APK. Maksymalny rozmiar pliku binarnego to 2048 MiB, czyli nieco ponad 2 GB.
Jeśli rozmiar pliku APK mieści się w limitach i można go odtworzyć, skontaktuj się z zespołem pomocy Firebase.
Nie udało się przesłać pliku APK za pomocą fastlane. Plik APK jest niepodpisany.
Sprawdź, czy plik APK jest podpisany przy użyciu tych danych:
apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk
Dystrybucja pakietów Android App Bundle
Błędy związane z logowaniem się przez media społecznościowe lub zewnętrznymi dostawcami interfejsu API
Gdy prześlesz plik AAB do App Distribution, Google Play automatycznie ponownie podpisze wygenerowany plik APK za pomocą testowego certyfikatu klucza podpisywania aplikacji. Jeśli chcesz nadal korzystać z ich usług, musisz zarejestrować aplikację u dostawców interfejsów API. Po podpisaniu certyfikat testowy aplikacji można wyświetlić w konsoli Firebase.
Czy przesyłane przeze mnie pliki AAB są też widoczne w Google Play?
Wersje AAB przesłane do App Distribution nie będą widoczne na koncie dewelopera w Google Play (dotyczy to Eksploratora pakietów aplikacji i wewnętrznego udostępniania aplikacji).
Co się stanie, jeśli odłączę Firebase od Google Play?
Jeśli aplikacja Firebase na Androida zostanie odłączona od Google Play:
nie będziesz mieć możliwości przesyłania nowych pakietów aplikacji do usługi App Distribution ani eksportowania ich do Google Play przez integrację z tą usługą;App Distribution
Istniejące wersje będą nadal dostępne w panelu Firebase App Distribution oraz dla testerów.
Wszystkie dane eksportowane wcześniej między Firebase a Google Play pozostaną dostępne w obu usługach.
Czy mogę ponownie spróbować połączyć aplikację z Google Play?
Aby rozpowszechniać pakiet aplikacji na Androida (AAB) w usłudze App Distribution i automatycznie łączyć przesłane pakiety AAB z projektem Firebase oraz kontem dewelopera w Google Play, musisz spełnić te wymagania:
Twoje konto dewelopera w Google Play ma jeden z tych poziomów dostępu: Właściciel lub Administrator.
W projekcie Firebase masz jedną z tych ról: Właściciel lub Administrator Firebase.
Aplikacja jest zarejestrowana w Firebase oraz na koncie dewelopera w Google Play. Oznacza to, że masz zarówno aplikację Firebase na Androida, jak i aplikację Google Play.
Zarówno aplikacja w Google Play, jak i aplikacja Firebase na Androida zostały zarejestrowane przy użyciu tej samej nazwy pakietu.
Aplikacja w Google Play jest skonfigurowana w panelu aplikacji i rozpowszechniana na jednej ze ścieżek Google Play (test wewnętrzny, test zamknięty, test otwarty i produkcja).
Zakończono sprawdzanie aplikacji w Google Play i aplikacja została opublikowana. Aplikacja jest opublikowana, jeśli w kolumnie Stan aplikacji widoczny jest jeden z tych stanów: Test wewnętrzny (nie wersja robocza testu wewnętrznego), Test zamknięty, Test otwarty lub Produkcja.
Jeśli przesłana przez Ciebie aplikacja nie spełniała wcześniej kryteriów połączenia, ale teraz już je spełnia, możesz ponownie spróbować połączyć aplikację Firebase na Androida z Google Play.
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, ale chce akceptować zaproszenia do aplikacji, może wyświetlić oczekujące zaproszenia bezpośrednio w aplikacji App Tester (instrukcje pobierania).
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.
Aplikacja nie wskazuje, że jest zainstalowana
Jeśli tester pobierze i zainstaluje wersję, ale interfejs z informacjami o aplikacji nie będzie wskazywał, że aplikacja jest zainstalowana, oznacza to, że jest to znane już nam problem. W niektórych przypadkach identyfikator pakietu w aplikacji Firebase nie pasuje do identyfikatora pakietu pliku APK.
Sprawdź, czy identyfikator pakietu pliku APK jest zgodny z identyfikatorem pakietu aplikacji Firebase, której użyto do przesłania dystrybucji.
Alert na Androidzie, że na urządzeniu nie można instalować nieznanych aplikacji
Alert na Androidzie pojawia się, jeśli uruchomiona aplikacja lub przeglądarka nie ma jeszcze uprawnień do instalowania aplikacji spoza Google Play. Aby przyznać uprawnienia:
Android w wersji 8 lub nowszej: w aplikacji Ustawienia kliknij Zezwalaj z tego źródła.
Android w wersji 7 lub starszej: w aplikacji Ustawienia kliknij Zabezpieczenia i wybierz Nieznane źródła. Gdy pojawi się odpowiedni komunikat, kliknij OK > Zaufaj.
Nie udaje się zainstalować testowych plików APK
Jeśli nie uda się zainstalować testowego pliku APK na urządzeniu testera:
- Sprawdź, czy certyfikaty w nowej wersji są zgodne z certyfikatami w wersji zainstalowanej na urządzeniu testera. System Android pozwala na aktualizację aplikacji tylko wtedy, gdy certyfikaty są zgodne. Więcej informacji znajdziesz w uwagach dotyczących podpisywania.
- Upewnij się, że aplikacja obsługuje wersję systemu operacyjnego urządzenia testowego (sprawdź
minSdkVersion
).
Nie możesz zalogować się w aplikacji Tester aplikacji na Androida
Jeśli aplikacja Tester aplikacji uniemożliwia Ci zalogowanie się i przekierowuje Cię z powrotem do ekranu logowania, być może używasz Google Workspace (dawniej G Suite), który zawiera ustawienia ograniczeń.
Aby usunąć ustawienia ograniczeń:
Błąd podczas instalowania pakietu AAB: „Nie można zainstalować aplikacji”
Ten błąd może wystąpić, gdy instalowana aplikacja wchodzi w konflikt z aplikacją już zainstalowaną na urządzeniu. Może to być na przykład inna wersja tej samej aplikacji z tymi samymi niestandardowymi uprawnieniami lub nazwą ContentProvider.
Możesz poprosić testera o zebranie raportu o błędzie natychmiast po wystąpieniu problemu i sprawdzenie raportu, aby uzyskać więcej informacji o jego przyczynie. Zanim tester zainstaluje nową aplikację, musi usunąć wszystkie aplikacje, które się z nią pokrywają.
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ć czynności opisane 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.
Testowanie na nowym urządzeniu z Androidem
Jeśli testujesz po raz pierwszy, przeczytaj artykuł Konfigurowanie funkcji testowania.
Jeśli jesteś testerem App Distribution i masz nowe urządzenie z Androidem, na którym chcesz przeprowadzić testy, zamiast przechodzić przez cały proces testowania, wykonaj te czynności:
Na urządzeniu z Androidem otwórz stronę appdistribution.firebase.google.com.
Zaloguj się na swoje konto testera i u dołu ekranu kliknij przycisk Pobierz aplikację Testerzy, aby zainstalować aplikację Testerzy aplikacji na Androida.
Włączanie funkcji testowania za pomocą pakietu Android SDK App Distribution
Skorzystaj z podanych niżej wskazówek, aby rozwiązać problemy związane z włączaniem alertów o nowych wersjach aplikacji lub przesyłaniem opinii na temat aplikacji za pomocą pakietu Android SDK App Distribution.
Tester nie może rozpocząć przesyłania opinii w aplikacji
Jeśli w swojej aplikacji masz już skonfigurowany pakiet SDK Androida App Distribution, aby umożliwić przesyłanie opinii w aplikacji, a Twoi testerzy nie mogą przesłać opinii, wykonaj te czynności:
Włącz szczegółowe logowanie w pakiecie SDK Androida App Distribution w aplikacji:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
Sprawdź, czy w dziennikach aplikacji nie ma komunikatów o błędach. Aby to zrobić, zastosuj filtr „FirebaseAppDistribution”.
Sprawdź, czy tester ma dostęp do zainstalowanej wersji:
Jeśli dzienniki wskazują, że „tester nie ma dostępu do tego zasobu”, może to oznaczać, że nie został on zaproszony do aplikacji lub nie ma dostępu do wersji.
W panelu App Distribution w konsoli Firebase znajdź dokładną wersję, która jest uruchomiona na urządzeniu testera, i upewnij się, że tester jest wymieniony na karcie wersji na karcie Testerzy i ma stan „Zaakceptowano”.
Jeśli nadal nie otrzymujesz opinii, wykonaj te czynności:
Na urządzeniu testowym zaloguj się w aplikacji App Tester lub w aplikacji internetowej testera. Pamiętaj, aby wybrać konto Google, którego użyto po raz pierwszy, gdy akceptowano zaproszenie do testowania aplikacji.Firebase App Distribution
Zainstaluj aplikację ponownie za pomocą Testera aplikacji lub testowej aplikacji internetowej, aby sprawdzić, czy tester ma dostęp do wersji.
Spróbuj przesłać opinię, ponownie logując się na to samo konto Google.
Upewnij się, że masz włączony interfejs API Testerzy aplikacji Firebase. Więcej informacji znajdziesz w artykule Włączanie interfejsu API Testera dystrybucji aplikacji.
W sekcji Ograniczenia klucza sprawdź, czy interfejs API Testerzy aplikacji Firebase znajduje się na liście dozwolonych interfejsów API.
Nieotrzymywanie opinii przesłanych w aplikacji
Jeśli podczas przesyłania opinii zobaczysz komunikat „Nie udało się przesłać opinii ze względu na tryb deweloperski”, wyłącz tryb deweloperski na urządzeniu, wykonując ten polecenie:
adb shell setprop debug.firebase.appdistro.devmode false
Sprawdź plik
google-services.json
, aby mieć pewność, że przesyłasz opinię dotyczącą właściwego projektu i aplikacji.Włącz szczegółowe logowanie w pakiecie SDK Androida App Distribution w aplikacji:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
Sprawdź, czy w dziennikach aplikacji nie ma komunikatów o błędach. Aby to zrobić, zastosuj filtr „FirebaseAppDistribution”.
Testerzy nie otrzymują powiadomień w aplikacji
Jeśli pakiet SDK do Androida App Distribution jest już skonfigurowany w aplikacji, a testerzy nie otrzymują alertów w aplikacji, wykonaj te czynności:
Sprawdzanie komunikatów o błędach przez dołączenie obiektu
OnFailureListener
do zadania zwracanego przez interfejs API Firebase App Distribution.Java
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 aplikacji. Więcej informacji znajdziesz w dokumentacji Google Analytics.
Uruchom aplikację w symulatorze i poszukaj ciągu znaków „FirebaseAppDistribution”.
Jeśli dzienniki wskazują, że nie znaleziono żadnej wersji lub że tester nie ma do niej dostępu, może to oznaczać, że nie jest on 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 alertów, poproś go o wykonywanie czynności opisanych poniżej, aby upewnić się, że zaakceptował on zaproszenie do testowania aplikacji i prawidłowo skonfigurował urządzenie testowe:
Na urządzeniu testowym zaloguj się w aplikacji Tester aplikacji lub w aplikacji internetowej dla testerów do Rozpowszechniania aplikacji przez Firebase. Pamiętaj, aby wybrać konto Google, którego użyto po raz pierwszy, gdy akceptowano zaproszenie do testowania aplikacji.
Sprawdź, czy nowa wersja aplikacji jest dostępna w aplikacji App Tester lub w aplikacji internetowej testera.
po zamknięciu aplikacji testerowi wyświetla się prośba o ponowne zalogowanie się.
Domyślnie testerzy muszą tylko raz zalogować się na swoje konto Google, aby włączyć funkcje testowania. 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 po wylogowaniu usuwasz SharedPreferences, możesz 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.
Jak długo wersje aplikacji są dostępne?
Wersje aplikacji są usuwane z App Distribution, jeśli spełniony jest 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 150-dniowy limit ważności lub limit 1000 wersji, zostanie usunięta z poziomu pulpitu App Distribution i aplikacji Firebase App Tester. 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 wygaśnie wersja aplikacji lub przekroczy limit wersji, pobierz plik APK lub pakiet aplikacji na Androida i usuń wersję z panelu App Distribution. Następnie ponownie prześlij plik APK lub pakiet aplikacji na Androida jako nową wersję do usługi 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 aplikacji Firebase App Tester na swoim urządzeniu testowym.
Gdy do daty wygaśnięcia pozostało 30 dni, w aplikacji Firebase App Tester pojawi się powiadomienie o wygaśnięciu wersji aplikacji.
App Distribution obsługuje maksymalnie 1000 wydań
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.
Jak uzyskać dostęp do aplikacji testowych zainstalowanych na moim urządzeniu?
Jeśli jesteś testerem, zalecamy pobranie aplikacji Firebase App Tester, która umożliwia dostęp do wszystkich wersji testowych w jednym miejscu.
Czy w przypadku funkcji Automated Tester obowiązują jakieś limity przydziału?
Firebase App Distribution korzysta z infrastruktury Firebase Test Lab, a limity i ceny są takie same. Limity testów są określane na podstawie liczby testów przeprowadzanych dziennie. Więcej informacji o testowaniu limitów i płatności znajdziesz w artykule Poziomy wykorzystania, limity i ceny w usłudze Test Lab.
Jakie są limity prób ponownego wykonania testu w przypadku przekroczenia limitu?
Jeśli przekroczysz limit, pojawią się błędy związane z przekroczeniem limitu. Resetowanie limitów trwa około 24 godzin, więc nie należy powtarzać prób do momentu, gdy limit zostanie zwolniony. Jeśli jednak pojawią się błędy związane z infrastrukturą testera automatycznego, spróbuj ponownie od razu, a zapytania będą prawdopodobnie skuteczniejsze.
Jakich uprawnień potrzebuję, aby korzystać z funkcji testowania automatycznego w wersji beta?
Aby uruchamiać testy za pomocą funkcji Automated Tester, musisz mieć w projekcie Firebase dostęp Edytujący.
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 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.