Na tej stronie znajdziesz pomoc w rozwiązywaniu problemów i odpowiedzi na najczęstsze pytania Pytania dotyczące dystrybucji i testowania aplikacji za pomocą App Distribution.
Dystrybucja 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 udostępnić aplikacji z powodu brakującego kontaktowego adresu e-mail
Podczas przesyłania aplikacji może pojawić się ten błąd:
„Nie udało nam się znaleźć kontaktowego adresu e-mail dla aplikacji <app-id>
. Aby go skonfigurować, otwórz stronę App Distribution w konsoli Firebase.
Ustaw kontaktowy adres e-mail w konsoli Firebase, jeśli jest dostępny. Jeśli problem 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 powtarzają się błędy 400, 409 lub 500, skontaktuj się z zespołem pomocy Firebase. Podaj Pomoc w zakresie numeru projektu Firebase i identyfikatora aplikacji.
Nie udało się przesłać pliku APK
Sprawdź rozmiar pliku APK. Maksymalny rozmiar wszystkich plików binarnych wynosi 2048 MiB, czyli nieco ponad 2 GB.
Jeśli rozmiar pliku APK nie przekracza limitu i można go odtworzyć, skontaktuj się z Pomoc Firebase.
Nie udało się przesłać pliku APK za pomocą fastlane. Plik APK nie jest podpisany.
Sprawdź, czy plik APK jest podpisany za pomocą tych danych:
apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk
Rozpowszechnianie pakietów aplikacji na Androida (Android App Bundle)
Błędy z wyświetlaniem reklam społecznościowych dostawcy interfejsów API do logowania i innych usług
Gdy prześlesz pakiet aplikacji na Androida do aplikacji App Distribution, Google Play automatycznie wyloguje w wygenerowanym pliku APK za pomocą certyfikatu klucza podpisywania aplikacji. Gdy pojawi się odpowiedni komunikat, jeśli chcesz nadal używać interfejsu API, musisz zarejestrować aplikację u dostawców interfejsów API usług innych firm. Po podpisaniu certyfikat testowy aplikacji może które można wyświetlić w konsoli Firebase.
Czy pakiety aplikacji na Androida, które przesyłam, pojawiają się też w Google Play?
Kompilacje pakietu aplikacji na Androida, które przesyłasz do App Distribution, nie pojawiają się w Google Play konta dewelopera (obejmuje to Eksploratora pakietów aplikacji i wewnętrzne udostępnianie aplikacji).
Co się stanie, jeśli odłączę Firebase od Google Play?
Po odłączeniu aplikacji Firebase na Androida od Google Play:
Utracisz możliwość przesyłania i eksportowania nowych pakietów aplikacji do usługi App Distribution można je przesłać do Google Play przez integrację App Distribution z Google Play.
Istniejące wersje będą nadal dostępne w panelu Firebase App Distribution oraz dla testerów.
Wszystkie dane wyeksportowane wcześniej między Firebase a Google Play pozostaną bez zmian. i w obu usługach.
Czy mogę jeszcze raz spróbować połączyć aplikację z Google? Odtworzyć?
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 elementów poziomy dostępu: Właściciel lub Administrator.
W projekcie Firebase masz jedną z tych ról: Właściciel lub Administrator Firebase.
Twoja aplikacja jest zarejestrowana w Firebase i u Twojego dewelopera w Google Play koncie. Oznacza to, że masz zarówno aplikację Firebase na Androida, jak i Aplikacja 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 została skonfigurowana w aplikacji, panel i jest rozpowszechniana na jednej ze ścieżek Google Play (testy wewnętrzne, (test zamknięty, otwarty lub wersja produkcyjna).
Zakończono sprawdzanie aplikacji w Google Play i aplikacja została opublikowana. Twoje aplikacja jest opublikowana, jeśli w kolumnie Stan aplikacji widać jeden z tych elementów: stany: Testy wewnętrzne (nie wersja robocza testów wewnętrznych), testy zamknięte, Testy otwarte lub produkcyjne.
Jeśli przesłano aplikację, która wcześniej nie spełniała podanych wyżej kryteriów, ale teraz już działa, możesz spróbować ponownie połączyć aplikację Firebase na Androida z Google Play.
Instalowanie i testowanie aplikacji
Postępuj zgodnie z poniższymi wskazówkami, aby rozwiązywać problemy, które mogą napotkać testerzy napotkanych podczas instalowania i testowania aplikacji.
Tester nie ma konta Google
Gdy użytkownik utworzy konto Google, automatycznie otrzyma adres Gmail.
Jeśli tester nie ma adresu Google Workspace ani adresu Gmail lub zamiast korzystać z innego adresu e-mail, poproś testera o połączenie konta adres e-mail do swojego konta i użyj go do zalogowania się.
Wybierając dodatkowy adres e-mail, tester musi przestrzegać tych 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, by podczas logowania się za pomocą tego adresu e-mail użyć hasła do konta Google adresu.
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). W ten sposób powstanie link w tle. Zawsze, gdy e-mail A jest dodany do nowych kompilacji, dostęp do niego ma w rzeczywistości adres e-mail B.
Jeśli tester zaakceptował e-maila z zaproszeniem, używając innego adresu e-mail, Aby rozwiązać problem, wykonaj następujące czynności:
Usuń testera z sekcji Wyświetl wszystkich testerów w sekcji Testerzy i Karta Grupy w: App Distribution w konsoli Firebase. Istniejące zaproszenia zostaną usunięte.
Ponownie zaproś testera do przetestowania aplikacji. Tester powinien otrzymać e-maila z zaproszeniem.
Sprawdź, czy tester zaakceptował zaproszenie z tego samego adresu e-mail.
Tester nie otrzymuje e-maili z powiadomieniami
Testerzy mogą nie otrzymywać powiadomień e-mail, jeśli wystąpi jedno z tych zdarzeń:
E-maile z powiadomieniami są wysyłane do folderów ze spamem.
Filtry e-maili są ustawione.
Zaproszenie zostało wysłane na 1 konto e-mail, ale tester je zaakceptował, podając innego konta 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ł pierwszego zaproszenia. Jeśli tester zostanie dodany do kolejnych wersji, App Distribution nie będzie automatycznie wysyłać powiadomień o wypuszczeniu, ponieważ nie zaakceptował on początkowego zaproszenia.
Rozwiązanie 1
Poproś testera o sprawdzenie folderu ze spamem i filtrów ustawionych w usłudze poczty e-mail.
Jeśli tester zrezygnował z subskrypcji e-maili, poproś go o wykonanie tych czynności: :
- Znajdź e-maila, którego tester wcześniej otrzymał z aplikacji.
- U dołu kliknij Zarządzaj ustawieniami poczty e-mail, a następnie Zezwól na e-maile. aby ponownie wykupić subskrypcję.
Rozwiązanie 2
Tester nie chce otrzymywać e-maili z powiadomieniami, ale chce mieć możliwość ich zaakceptowania mogą wyświetlać oczekujące zaproszenia do aplikacji bezpośrednio w aplikacji Aplikacja testowa (instrukcje pobierania).
Rozwiązanie 3
Usuń testera w 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ń.
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
Tester pobierze i zainstaluje wersję, ale interfejs szczegółów aplikacji nie pokazuje, że aplikacja jest zainstalowana – to znany problem. W niektórych przypadkach identyfikator pakietu w aplikacji Firebase nie odpowiada identyfikatorowi pakietu APK.
Sprawdź, czy identyfikator pakietu APK odpowiada identyfikatorowi pakietu w Firebase. aplikacji użytej do przesłania pliku do dystrybucji.
Alert na Androidzie informujący, że na urządzeniu nie można instalować nieznanych aplikacji
Alert Androida pojawia się, jeśli Twoja uruchomiona aplikacja lub przeglądarka nie zostały jeszcze udostępnione uprawnienia 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 Bezpieczeństwo. i wybierz Nieznane źródła. Gdy pojawi się odpowiedni komunikat, kliknij OK > Zaufaj.
Nie można zainstalować testowych plików APK
Jeśli nie można zainstalować testowego pliku APK na urządzeniu testera:
- Sprawdź, czy certyfikaty w nowej wersji są zgodne z wersję zainstalowaną na urządzeniu testera. System Android zezwala na zaktualizować aplikację, jeśli certyfikaty są zgodne. Więcej informacji znajdziesz w artykule Uwagi na temat podpisywania.
- Sprawdź, czy 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ń:
Na karcie Aplikacje na koncie W Google Workspace sprawdź, czy Firebase App Distribution ma wartość nie ustawioną na Dostęp: zablokowany.
Na karcie Usługi sprawdź, czy Cloud Platform nie jest ograniczona.
Po usunięciu ustawień spróbuj jeszcze raz się zalogować.
Podczas instalowania pakietu aplikacji na Androida wystąpił błąd: „Nie można zainstalować aplikacji”
Ten błąd może wystąpić, gdy instalowana aplikacja powoduje konflikt z aplikacją, która już została zainstalowana zainstalowanej na urządzeniu. Może to być na przykład inny wariant atrybutu ta sama aplikacja z tym samym niestandardowe uprawnienia lub Nazwa dostawcy treści.
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 uprawnienia 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, które nie ma ograniczonych możliwości instalowania i testowania aplikacji.
Testowanie na nowym urządzeniu z Androidem
Jeśli jesteś testerem po raz pierwszy, przeczytaj artykuł Przygotowanie jako tester.
Jeśli jesteś już testerem wersji App Distribution i dostaniesz nowe urządzenie z Androidem, nie musisz powtarzać całego procesu, zastosuj się do tych wskazówek: kroki:
Na urządzeniu z Androidem otwórz stronę appdistribution.firebase.google.com.
Zaloguj się na istniejące konto testera i kliknij Pobierz aplikację Tester u dołu ekranu, by zainstalować aplikację Android App Tester. .
Włączanie funkcji testerów za pomocą pakietu SDK na Androida App Distribution
Skorzystaj z podanych niżej wskazówek, aby rozwiązać problemy związane z włączeniem nowych elementów w aplikacji alerty o tworzeniu aplikacji oraz przesyłanie opinii w aplikacji za pomocą pakietu SDK na Androida w wersji App Distribution.
Tester nie może rozpocząć przekazywania opinii w aplikacji
Jeśli w swojej aplikacji masz już skonfigurowany pakiet SDK App Distribution na Androida, a testerzy nie mogą przesyłać opinii w aplikacji, postępuj zgodnie z tymi kroki:
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 do niego dostępu zasobu”, tester mógł nie zostać zaproszony do aplikacji lub może nie mieć dostępu do tego wydania.
W panelu App Distribution w konsoli Firebase znajdź dokładną wersję używanej wersji na urządzeniu testera i upewnić się, testera znajdziesz na karcie Testerzy na karcie wersji i w Stan: zaakceptowano.
Jeśli nadal nie otrzymujesz opinii, wykonaj te czynności:
Na urządzeniu testowym zaloguj się w aplikacji Firebase App Distribution za pomocą aplikacji Tester lub aplikacja internetowa testera. Wybierz konto Google użyte podczas akceptacji zaproszenia do testowania aplikacji.
Zainstaluj ponownie aplikację, korzystając z usługi App Tester lub testowej aplikacji internetowej, aby sprawdź, czy tester ma dostęp do wersji.
Spróbuj przesłać opinię, logując się na tym samym koncie Google.
Sprawdź, czy masz włączony interfejs Firebase App Testers API. Więcej informacji znajdziesz w artykule Włączanie interfejsu API Testera dystrybucji aplikacji.
W sekcji Ograniczenia kluczy sprawdź, czy interfejs Firebase App Testers API jest na liście dozwolonych interfejsów API.
Brak opinii przesłanych w aplikacji
Jeśli podczas przesyłania opinii zostanie wyświetlony komunikat: „Można przesłać opinię, ale nie ze względu na tryb deweloperski”, wyłącz tryb programisty na urządzeniu, uruchamiając to polecenie:
adb shell setprop debug.firebase.appdistro.devmode false
Sprawdź plik
google-services.json
, aby upewnić się, że go przesyłasz dotyczące odpowiedniego projektu i aplikacji.Włącz logowanie szczegółowe w przypadku pakietu SDK Androida App Distribution w swojej aplikacji:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
Sprawdź, czy w logach aplikacji nie ma komunikatów o błędach, filtrując je według: „FirebaseAppDystrybucja”.
Tester nie otrzymuje alertów w aplikacji
Jeśli w swojej aplikacji masz już skonfigurowany pakiet SDK App Distribution na Androida oraz 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 swojej aplikacji. Instrukcje znajdziesz w dokumentacji Google Analytics.
uruchomić aplikację w symulatorze i wyszukać ciąg znaków. „FirebaseAppDystrybucja”.
Jeśli dzienniki wskazują, że nie znaleziono żadnej wersji lub jeśli tester to robi nie masz dostępu, Twój tester może nie być jeszcze powiązany z nowym wersji.
W panelu App Distribution Firebase – upewnij się, że tester jest uwzględniony w kompilacji dystrybucji i ma stan Zaakceptowano.
Jeśli tester nadal nie otrzymuje alertów, poproś go o zastosowanie się do wskazówek poniżej, by upewnić się, że użytkownik zaakceptował zaproszenie do testowania aplikacji, oraz o prawidłowej konfiguracji urządzenia testowego:
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 App Tester, lub aplikację internetową testera.
Po zamknięciu aplikacji tester prosi o ponowne zalogowanie się
Domyślnie testerzy muszą zalogować się na swoje konto Google tylko raz, aby: włączyć funkcje testowe. 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 więcej informacji znajdziesz w artykule Włączanie interfejsu App Distribution Tester API.
W sekcji Ograniczenia kluczy sprawdź, czy interfejs Firebase App Testers API jest na liście dozwolonych interfejsów API.
Jeśli przy wylogowaniu zwykle wyczyszczono element SharedPreferences, może to być o stanie testera. App Distribution przechowuje flagę, która wskazuje, Tester jest już zalogowany w aplikacji. Więcej informacji: Repozytorium GitHub.
Najczęstsze pytania
Czy są jakieś limity dodawania testerów do aplikacji?
Firebase App Distribution ma te limity testerów:
Dodawanie do projektu Firebase maksymalnie 500 testerów
Do grupy App Distribution możesz dodać maksymalnie 200 testerów
Aby dodać więcej testerów, poproś o bezpłatnych wyników zwiększenie limitu.
Czy zaproszenia dla testerów wygasają?
Testerzy mają 30 dni na zaakceptowanie zaproszenia do testowania aplikacji, zanim utraci ono ważność. Jeśli zaproszenie wygasa po 5 dniach, na stronie Konsola Firebase obok testera przy wersji. Zaproszenie można odnowić Wyślij ją ponownie, korzystając z menu w wierszu testera.
Jak długo dostępne są wersje aplikacji?
Wersje aplikacji są usuwane z App Distribution, jeśli wystąpi jeden z tych warunków następuje:
- 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 sekcji App Distribution obsługuje maksymalnie 1000 wersji.
Gdy aplikacja osiągnie lub przekroczy limit 150 dni lub limit 1000 wersji, zostanie usunięta z panelu 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 dłużej dostępna, użyj jednej z tych opcji: zalecenia:
- Zanim wersja aplikacji wygaśnie 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ą kompilację do App Distribution.
- Pobierz wersję i prześlij ją do Cloud Storage na potrzeby długoterminowej archiwizacji.
Wersje aplikacji wygasają po 150 dniach
Gdy prześlesz wersję aplikacji do Firebase, pojawi się ona w Panel App Distribution przez 150 dni, licząc od daty przesłania. Po przesłaniu wersji może rozpowszechnić ją testerom, którzy instalują wersję z aplikacji Firebase Aplikacja testera na urządzeniu testowym.
Jeśli upłynie 30 dni od daty ważności, kolejne wersje aplikacji powiadomienie o wygaśnięciu pojawi się w wersji w aplikacji Firebase App Tester.
App Distribution obsługuje maksymalnie 1000 wersji
App Distribution zezwala na maksymalnie 1000 wersji na aplikację. Gdy Twoja aplikacja osiągnie limit 1000 wersji, App Distribution automatycznie usuwa najstarsze przekroczy limit.
Jeśli chcesz ręcznie zarządzać wersjami aplikacji, użyj interfejsu API REST App Distribution do listy i usuń zbiorczych wersji aplikacji.
Jeśli masz pytania, skontaktuj się z zespołem pomocy Firebase.
Jak uzyskać dostęp do aplikacji testowych zainstalowanych na 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 automatycznego testowania są jakieś limity?
Usługa Firebase App Distribution korzysta z infrastruktury Firebase Test Lab i jej limitu limity i ceny są takie same. Limity testowania są mierzone przez liczbę testów dziennie. Więcej informacji o limitach testowania i rozliczeniach znajdziesz w artykule Wykorzystanie poziomów, limitów i cen dla 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. Zajmują one około 24 godzin do zresetowania, dlatego nie ponawiaj próby przed zwolnieniem limitu. Jeśli jednak otrzymujesz błędy związane z infrastrukturą automatycznych testerów, połączenia są bardziej od razu spróbować ponownie.
Jakie uprawnienia są potrzebne do uruchomienia funkcji automatycznego testowania w wersji beta?
Aby uruchomić projekt Firebase, musisz mieć uprawnienia do jego edycji w projekcie Firebase za pomocą automatycznego testera.
Jak usunąć konto testera?
Aby usunąć konto testera App Distribution i powiązane z nim dane: wykonaj te kroki w odpowiedniej kolejności:
Wejdź na stronę https://appdistribution.firebase.google.com. i zaloguj się na swoje konto Google.
W prawym górnym rogu kliknij settings (Zarządzaj kontem).
Usuń konto.
Opcjonalnie: w sekcji Uprawnienia dotyczące konta Google: cofnij dostęp dla: Firebase App Distribution. Pamiętaj, że odebranie dostępu bez pierwsze usunięcie konta App Distribution nie spowoduje usunięcia testera konta lub danych.