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.
Dystrybucja aplikacji
Skorzystaj z podanych niżej wskazówek, aby rozwiązać problemy, które mogą wystąpić podczas rozpowszechniania aplikacji dla testerów.
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źć 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 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 z paskiem szybkiego ruchu. 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
Dystrybucja pakietów 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 plik AAB do App Distribution, Google Play automatycznie ponownie podpisze wygenerowany plik APK za pomocą testowego 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żna wyświetlić w konsoli Firebase.
Czy przesł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ę konto Firebase z 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ą;
Istniejące kompilacje będą nadal dostępne w Firebase App Distribution panel i dla testerów.
Wszystkie dane eksportowane wcześniej między Firebase a Google Play pozostaną dostępne 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 została zarejestrowana w Firebase i zarejestrowana przez 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 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. 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ł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
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 tworzy konto Google, automatycznie otrzymuje 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 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.
Testerzy nie widzą odpowiednich aplikacji lub kompilacji
Jeśli tester zaakceptował e-maila z zaproszeniem, podając inny adres e-mail niż tester może nie widzieć właściwych aplikacji lub do tworzenia kampanii.
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.
Sprawdź, czy tester zaakceptował zaproszenie z tego samego adresu e-mail.
Tester nie otrzymuje e-maili z powiadomieniami
Testerzy mogą nie otrzymywać e-maili z powiadomieniami, jeśli:
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 wersjach do tego testera, ponieważ nie zaakceptował on początkowego zaproszenia.
Rozwiązanie 1
Poproś testera o sprawdzenie folderu ze spamem i filtrów ustawionych w usługach 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.
- U dołu kliknij Zarządzaj ustawieniami poczty e-mail, a następnie wybierz Zezwól na e-maile. aby ponownie wykupić subskrypcję.
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świetl wszystkich testerów w sekcji Testerzy i Karta Grupy w: App Distribution w konsoli Firebase. Ta czynność 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 ono 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, jest to znane nam już problem. W niektórych przypadkach identyfikator pakietu w aplikacji Firebase nie pasuje do identyfikatora pakietu pliku APK.
Sprawdź, czy identyfikator pakietu APK odpowiada identyfikatorowi pakietu w Firebase. aplikacji użytej do przesłania pliku do 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ę 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 uwagach dotyczących podpisywania.
- Upewnij się, że aplikacja obsługuje wersję systemu operacyjnego urządzenia testera (sprawdź
minSdkVersion
).
Nie możesz zalogować się w aplikacji Tester aplikacji na Androida
Jeśli aplikacja App Tester uniemożliwia zalogowanie się i przekierowuje z powrotem do ekran logowania – być może używasz Google Workspace (dawniej G Suite) która obejmuje 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 ma ograniczeń.
Gdy usuniesz ustawienia, spróbuj się zalogować ponownie.
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 pobranie raport o błędzie natychmiast po wystąpieniu problemu i sprawdź raport, aby uzyskać więcej informacji. o przyczynie. Tester musi usunąć wszystkie aplikacje powodujące konflikty przed że będzie można zainstalować nową aplikację.
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, 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 testowania w pakiecie 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 SDK Androida 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 logowanie szczegółowe w przypadku pakietu SDK Androida App Distribution w swojej aplikacji:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
Poszukaj komunikatów o błędach w dziennikach aplikacji, filtrując dane według „FirebaseApp Distributionion”.
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ę 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 aplikację ponownie za pomocą Testera aplikacji lub testowej aplikacji internetowej, aby sprawdzić, czy tester ma dostęp do wersji.
Spróbuj przesłać opinię, logując się na tym samym koncie Google.
Upewnij się, że 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.
Brak opinii przesłanych w aplikacji
Jeśli podczas przesyłania opinii widzisz 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 logowanie szczegółowe w przypadku pakietu SDK Androida App Distribution w swojej aplikacji:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
Sprawdź, czy w dziennikach aplikacji pojawiają się komunikaty o błędach. Aby to zrobić, zastosuj filtr „FirebaseAppDistribution”.
Tester nie otrzymuje alertów 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:
Sprawdź, czy nie ma komunikatów o błędach, dołączając
OnFailureListener
do zadania zwracane przez interfejs Firebase App Distribution API.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 jeśli tester to robi nie masz dostępu, Twój tester może nie być jeszcze powiązany z nowym wersji.
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 przestrzeganie poniższych 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 Rozpowszechnianiu aplikacji przez aplikację w Firebase przez testera lub przez aplikację internetową testera, Pamiętaj, aby wybrać Google konta użytego po raz pierwszy do przyjęcia zaproszenia do testowania .
Sprawdź, czy nowa wersja aplikacji jest dostępna w App Tester, lub aplikację internetową testera.
po zamknięciu aplikacji tester został poproszony o ponowne zalogowanie się.
Domyślnie testerzy muszą zalogować się na swoje konto Google tylko raz, aby: włączyć funkcje testowe. Jeśli testerzy po zamknięciu i ponownym uruchomieniu aplikacji pojawi się prośba o zalogowanie się, wykonaj te czynności: kilka wskazówek, jak upewnić się, że konfiguracja App Distribution jest prawidłowa:
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 zwykle po wylogowaniu usuwasz SharedPreferences, możesz usuwać stan 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łatne zwiększenie limitu.
Czy moje zaproszenia do testowania wygasają?
Testerzy mają 30 dni na zaakceptowanie zaproszenia do testowania aplikacji, zanim wygaśnie. Jeśli zaproszenie wygasa po 5 dniach, w sekcji Konsola Firebase obok testera przy wersji. 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 wystąpi jeden z tych warunków następuje:
- wersja aplikacji jest starsza niż 150 dni,
- Osiągnięto limit 1000 wersji aplikacji, a wersja 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 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 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 AAB 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 na stronie 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, 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 urządzeniu?
Jeśli jesteś testerem, zalecamy pobranie Firebase App Tester – aplikacja, która zapewnia dostęp do wszystkich kompilacji testowych w jednym miejscu.
Czy w przypadku funkcji automatycznego testowania są jakieś limity?
Firebase App Distribution korzysta z infrastruktury Firebase Test Lab, a jego 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 przekroczenia limitu. Resetowanie limitów trwa około 24 godzin, więc nie należy podejmować prób ponownego wykonania operacji, dopóki limit nie zostanie zwolniony. Jeśli jednak pojawią się błędy związane z infrastrukturą testera automatycznego, spróbuj ponownie od razu.
Jakich uprawnień potrzebuję, aby korzystać z funkcji testowania automatycznego w wersji beta?
Aby uruchamiać testy za pomocą funkcji Automated Tester, musisz mieć dostęp do edycji projektu Firebase.
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 uprawnieniach konta Google cofnij dostęp aplikacji Firebase App Distribution. Pamiętaj, że odebranie dostępu bez pierwsze usunięcie konta App Distribution nie spowoduje usunięcia testera konta lub danych.