Na tej stronie znajdziesz pomoc w rozwiązywaniu problemów oraz odpowiedzi na często zadawane pytania dotyczące dystrybucji i testowania aplikacji za pomocą aplikacji App Distribution.
Dystrybucja aplikacji
Skorzystaj z poniższych wskazówek, aby rozwiązać problemy, które możesz napotkać podczas dystrybucji aplikacji wśród testerów.
Podczas przesyłania aplikacji może pojawić się następujący błąd:
„Nie znaleźliśmy kontaktowego adresu e-mail dla aplikacji <app-id>
. Odwiedź stronę Dystrybucja aplikacji w konsoli Firebase, aby go 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 udostępniania wielokrotnie napotykasz błędy 400, 409 lub 500, skontaktuj się z pomocą techniczną Firebase . Zapewnij pomoc techniczną, podając numer projektu Firebase i identyfikator aplikacji.
Sprawdź rozmiar pliku APK. Maksymalny limit rozmiaru pliku dla wszystkich plików binarnych wynosi 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 następujących poleceń:
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 App Distribution, Google Play automatycznie rezygnuje z wygenerowanego pliku APK, korzystając z certyfikatu klucza podpisywania aplikacji testowej. Po wyświetleniu monitu musisz zarejestrować swoją aplikację u dostawców API, jeśli chcesz nadal korzystać z ich usług stron trzecich. Po podpisaniu certyfikat testowy aplikacji można wyświetlić w konsoli Firebase.
Kompilacje AAB przesłane do App Distribution nie pojawiają się na Twoim koncie programisty w 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, wydarzy się co następuje:
Nie będziesz mieć możliwości przesyłania nowych pakietów aplikacji do App Distribution i eksportowania ich do Google Play poprzez integrację App Distribution z Google Play.
Istniejące kompilacje będą nadal dostępne w panelu dystrybucji aplikacji Firebase i dla testerów.
Wszelkie dane wyeksportowane wcześniej między Firebase i Google Play pozostaną dostępne w obu produktach.
Aby dystrybuować pakiet aplikacji na Androida (AAB) za pośrednictwem App Distribution i automatycznie łączyć przesłane pakiety AAB zarówno z projektem Firebase, jak i kontem programisty w Google Play, upewnij się, że spełniasz następujące wymagania:
Twoje konto programisty w 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.
Zarówno aplikacja w Google Play, jak i aplikacja Firebase na Androida są zarejestrowane przy użyciu tej samej nazwy pakietu.
Aplikację w Google Play konfiguruje się na panelu aplikacji i dystrybuuje do jednej ze ścieżek Google Play (testy wewnętrzne, testy zamknięte, testy otwarte lub produkcja).
Zakończono sprawdzanie aplikacji w Google Play i opublikowano ją. Twoja aplikacja została 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łałeś aplikację, która wcześniej nie spełniała powyższych kryteriów łączenia, ale teraz tak się dzieje, możesz spróbować ponownie 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 mogą napotkać testerzy podczas instalowania i testowania aplikacji.
Kiedy użytkownik tworzy konto Google, automatycznie otrzymuje adres Gmail.
Jeśli tester nie ma adresu Google Workspace ani Gmaila albo woli do logowania się użyć innego adresu e-mail, poproś testera o powiązanie z kontem adresu e-mail innego niż Gmail i używanie tego adresu e-mail do logowania.
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ż powiązany z innym kontem Google.
- Pamiętaj, aby zalogować się przy użyciu tego adresu e-mail, używając hasła do konta Google.
Więcej informacji znajdziesz w artykule 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ż zaproszenie, na które zaproszenie zostało wysłane, tester może nie widzieć odpowiednich aplikacji lub kompilacji.
Adres e-mail, na który programista wysyła zaproszenia i dodaje je do nowych kompilacji (e-mail A), może różnić się od adresu e-mail, którego tester używa do zaakceptowania zaproszenia (e-mail B). Tworzy to połączenie za kulisami. Za każdym razem, gdy do nowych kompilacji dodawany jest adres e-mail A, w rzeczywistości dostęp do niego uzyskuje adres e-mail B.
Jeśli tester przyjął zaproszenie e-mail z innym adresem e-mail, wykonaj poniższe kroki, aby rozwiązać problem:
Usuń testera z sekcji Wyświetl wszystkich testerów na karcie Testerzy i grupy na stronie Dystrybucja aplikacji w konsoli Firebase. Istniejące zaproszenia zostaną usunięte.
Ponownie zaproś testera do przetestowania aplikacji. Tester powinien otrzymać e-mail z zaproszeniem.
Upewnij się, że tester przyjął zaproszenie z tym samym adresem e-mail.
Testerzy mogą nie otrzymać powiadomień e-mail, jeśli wystąpi jedna z poniższych sytuacji:
Powiadomienia e-mail trafiają do folderów ze spamem.
Filtry poczty e-mail są ustawione.
Zaproszenie zostało wysłane na jedno konto e-mail, ale tester zaakceptował je, korzystając z innego konta e-mail. Tester otrzymuje e-maile 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 wydań, 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, aby sprawdził folder ze spamem i wszelkie filtry poczty e-mail ustawione w usłudze poczty e-mail.
Jeśli tester zrezygnował z subskrypcji e-maili, poproś testera o wykonanie następujących czynności:
- Znajdź e-mail, który tester otrzymał wcześniej z aplikacji.
- Kliknij Zarządzaj ustawieniami poczty e-mail na dole i kliknij Zezwól na ponowną subskrypcję wiadomości e-mail .
Rozwiązanie 2
Jeśli tester nie chce powiadomień e-mail, ale chce mieć możliwość akceptowania zaproszeń z aplikacji, może wyświetlić oczekujące zaproszenia z aplikacji bezpośrednio w aplikacji Tester aplikacji ( instrukcje pobierania ).
Rozwiązanie 3
Usuń testera z sekcji Wyświetl wszystkich testerów na karcie Testerzy i grupy na stronie Dystrybucja aplikacji w konsoli Firebase. Ta czynność powoduje usunięcie istniejących zaproszeń.
Ponownie zaproś testera do przetestowania aplikacji. Tester powinien otrzymać e-mail z zaproszeniem. Upewnij się, że tester przyjął zaproszenie z tego samego adresu e-mail, na który zaproszenie zostało wysłane.
Jeśli tester pobiera i instaluje wersję, ale interfejs użytkownika ze szczegółami aplikacji nie pokazuje, że aplikacja jest zainstalowana, jest to znany problem. W niektórych przypadkach identyfikator pakietu w aplikacji Firebase nie jest zgodny z identyfikatorem pakietu w pliku APK.
Sprawdź, czy identyfikator pakietu APK jest zgodny z identyfikatorem pakietu aplikacji Firebase użytej do przesłania dystrybucji.
Alert dla systemu Android pojawia się, jeśli uruchomiona aplikacja lub przeglądarka nie otrzymała jeszcze pozwolenia na instalowanie aplikacji poza Google Play. Aby udzielić pozwolenia:
Android w wersji 8 lub nowszej : w aplikacji Ustawienia dotknij opcji Zezwalaj 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 testowy plik APK nie zostanie zainstalowany na urządzeniu testera:
- Sprawdź, czy certyfikaty w nowej wersji odpowiadają tym w wersji zainstalowanej na urządzeniu testera. System Android pozwala na aktualizację aplikacji tylko wtedy, gdy certyfikaty są zgodne. Aby dowiedzieć się więcej, zobacz temat Uwagi dotyczące podpisywania .
- Upewnij się, że aplikacja obsługuje wersję systemu operacyjnego urządzenia testowego (sprawdź
minSdkVersion
).
Jeśli aplikacja App Tester uniemożliwia zalogowanie się i przekierowuje z powrotem do ekranu logowania, być może korzystasz z Google Workspace (dawniej GSuite) zawierającego ustawienia ograniczeń.
Aby usunąć ustawienia ograniczeń:
Upewnij się, że na karcie Aplikacje w Google Workspace Dystrybucja aplikacji Firebase nie jest ustawiona na Dostęp: Zablokowany .
Na karcie Usługi upewnij się, że 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 tymi samymi uprawnieniami niestandardowymi lub nazwą dostawcy treści .
Możesz poprosić testera o zebranie raportu o błędzie natychmiast po wystąpieniu problemu i sprawdzić raport, aby uzyskać więcej informacji na temat przyczyny. Tester musi usunąć wszystkie aplikacje powodujące konflikt, zanim będzie można zainstalować nową aplikację.
Gdy pojawi się błąd 403, oznacza to, że konto, którego używasz, nie ma uprawnień do instalowania i testowania aplikacji. Dostęp ustala administrator 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 zawartymi 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, na którym nie ma ograniczeń w zakresie instalowania i testowania aplikacji.
Jeśli jesteś testerem po raz pierwszy, zobacz Jak skonfigurować się jako tester .
Jeśli jesteś już testerem dystrybucji aplikacji i chcesz przetestować nowe urządzenie z Androidem, zamiast ponownie przechodzić przez cały proces nowego testera, wykonaj następujące kroki:
Przejdź do appdistribution.firebase.google.com na swoim urządzeniu z Androidem.
Zaloguj się na swoje istniejące konto testera i kliknij przycisk Pobierz tester aplikacji u dołu ekranu, aby zainstalować aplikację Android App Tester.
Włączanie funkcji testera za pomocą zestawu SDK aplikacji do dystrybucji aplikacji dla systemu Android
Skorzystaj z poniższych wskazówek, aby rozwiązać problemy związane z włączaniem alertów o nowych kompilacjach w aplikacji lub przesyłaniem opinii w aplikacji za pomocą zestawu SDK aplikacji do dystrybucji aplikacji dla systemu Android.
Jeśli w swojej aplikacji skonfigurowałeś już pakiet SDK do dystrybucji aplikacji dla systemu Android, aby obsługiwał opinie w aplikacji, a testerzy nie mogą przesyłać opinii, wykonaj następujące kroki:
Włącz w swojej aplikacji szczegółowe rejestrowanie dla zestawu SDK aplikacji do dystrybucji aplikacji dla systemu Android:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
Sprawdź komunikaty o błędach w dziennikach aplikacji, filtrując według „FirebaseAppDistribution”.
Potwierdź, że tester ma dostęp do zainstalowanej wersji:
Jeśli dzienniki wskazują, że „tester nie ma dostępu do tego zasobu”, mógł on nie zostać zaproszony do aplikacji lub nie mieć dostępu do wersji.
W panelu dystrybucji aplikacji w konsoli Firebase znajdź dokładną wersję uruchomioną na urządzeniu testera i upewnij się, że tester jest wymieniony na karcie Testerzy na karcie wersji i ma stan Zaakceptowany.
Jeśli nadal nie otrzymujesz opinii, wykonaj następujące kroki:
Na urządzeniu testowym zaloguj się do Firebase App Distribution przy użyciu narzędzia App Tester lub aplikacji internetowej testera. Pamiętaj, aby wybrać konto Google, którego użyłeś po raz pierwszy, przyjmując zaproszenie do testowania aplikacji.
Zainstaluj aplikację ponownie za pomocą narzędzia App Tester lub testowej aplikacji internetowej, aby upewnić się, że 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 testerów aplikacji Firebase. Aby uzyskać więcej informacji, zobacz Włączanie interfejsu API testera dystrybucji aplikacji .
W obszarze Ograniczenia klucza upewnij się, że interfejs API Firebase App Testers znajduje się na liście dozwolonych interfejsów API.
Jeśli podczas przesyłania opinii zobaczysz ten komunikat: „Wysłałbym opinię, ale nie zrobił tego ze względu na tryb programistyczny”, 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 przesyłasz opinię na temat prawidłowego projektu i aplikacji.Włącz w swojej aplikacji szczegółowe rejestrowanie dla zestawu SDK aplikacji do dystrybucji aplikacji dla systemu Android:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
Sprawdź komunikaty o błędach w dziennikach aplikacji, filtrując według „FirebaseAppDistribution”.
Jeśli w swojej aplikacji masz już skonfigurowany zestaw SDK do dystrybucji aplikacji dla systemu Android, a 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 API dystrybucji aplikacji Firebase.Jawa
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> { if (e instanceof FirebaseAppDistributionException) { // Log exception here }});
Kotlina
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, Twój tester może nie być jeszcze powiązany z nową wersją.
Upewnij się, że na panelu dystrybucji aplikacji w konsoli Firebase Twój tester jest uwzględniony w Twojej dystrybucji kompilacji i ma stan Zaakceptowany .
Jeśli tester nadal nie otrzymuje alertów, poproś go, aby zastosował się do poniższych wskazówek, aby upewnić się, że przyjął zaproszenie do testowania Twojej aplikacji i że prawidłowo skonfigurował urządzenie testowe:
Na urządzeniu testowym zaloguj się do Firebase App Distribution za pomocą narzędzia App Tester lub aplikacji internetowej testera. Pamiętaj, aby wybrać konto Google, którego użyłeś po raz pierwszy, przyjmując zaproszenie do testowania aplikacji.
Sprawdź, czy nowa wersja aplikacji jest dostępna w Testerze aplikacji lub aplikacji internetowej testera.
Domyślnie testerzy muszą zalogować się na swoje konto Google tylko raz, aby włączyć funkcje testowania. Jeśli po zamknięciu i ponownym otwarciu aplikacji testerzy zostaną poproszeni o ponowne zalogowanie się, postępuj zgodnie z poniższymi wskazówkami, aby upewnić się, że konfiguracja Dystrybucji aplikacji jest prawidłowo skonfigurowana:
Sprawdź, czy masz włączony interfejs API testerów aplikacji Firebase. Aby uzyskać więcej informacji, zobacz Włączanie interfejsu API testera dystrybucji aplikacji .
W obszarze Ograniczenia klucza upewnij się, że interfejs API Firebase App Testers znajduje się na liście dozwolonych interfejsów API.
Jeśli zazwyczaj czyścisz SharedPreferences przy wylogowaniu, być może czyścisz stan testera. Dystrybucja aplikacji przechowuje flagę wskazującą, czy tester zalogował się już do aplikacji. Więcej informacji znajdziesz w 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 przyjęcie zaproszenia do przetestowania aplikacji, zanim wygaśnie. Gdy do wygaśnięcia zaproszenia pozostało 5 dni, w konsoli Firebase obok testera w wersji 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 dystrybucji aplikacji, jeśli spełniony jest jeden z następujących warunków:
- Wersja aplikacji jest starsza niż 150 dni.
- Przekraczasz limit 1000 wydań aplikacji, a wersja aplikacji jest starsza niż 1000 najnowszych wydań.
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 wydań, wersja zostanie usunięta z panelu dystrybucji aplikacji i aplikacji Firebase App Tester. Jeśli tester zainstalował tę wersję, lokalna wersja aplikacji będzie nadal działać.
Aby wersja aplikacji była dłużej dostępna, skorzystaj z jednego z poniższych zaleceń:
- Zanim wersja aplikacji wygaśnie lub przekroczy limit wersji, pobierz plik APK lub AAB i usuń wersję z panelu dystrybucji aplikacji. Następnie prześlij ponownie plik APK lub AAB jako nową wersję do App Distribution.
- Pobierz wersję i prześlij ją do Cloud Storage w celu długoterminowej archiwizacji.
Wersje aplikacji wygasają po 150 dniach
Gdy prześlesz wersję 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 udostępnić ją testerom, którzy instalują ją z aplikacji Firebase App Tester na swoim urządzeniu testowym.
Jeśli od daty wygaśnięcia do wydania minęło 30 dni, w aplikacji Firebase App Tester pojawi się powiadomienie o wygaśnięciu wersji aplikacji.
Dystrybucja aplikacji obsługuje maksymalnie 1000 wydań
Dystrybucja aplikacji umożliwia maksymalnie 1000 wydań na aplikację. Kiedy Twoja aplikacja osiągnie limit 1000 wydań, usługa App Distribution automatycznie usuwa najstarsze wydania powyżej limitu.
Jeśli chcesz ręcznie zarządzać wydaniami aplikacji, użyj interfejsu API REST dystrybucji aplikacji, aby zbiorczo wyświetlać i usuwać wydania 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 wersji testowych w jednym miejscu.
Aby usunąć swoje konto testera dystrybucji aplikacji i powiązane z nim dane, wykonaj w podanej kolejności następujące kroki:
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 konta Google odbierz dostęp z Firebase App Distribution. Pamiętaj, że cofnięcie dostępu bez uprzedniego usunięcia konta Dystrybucji aplikacji nie powoduje usunięcia konta testera ani danych.
Na tej stronie znajdziesz pomoc w rozwiązywaniu problemów oraz odpowiedzi na często zadawane pytania dotyczące dystrybucji i testowania aplikacji za pomocą aplikacji App Distribution.
Dystrybucja aplikacji
Skorzystaj z poniższych wskazówek, aby rozwiązać problemy, które możesz napotkać podczas dystrybucji aplikacji wśród testerów.
Podczas przesyłania aplikacji może pojawić się następujący błąd:
„Nie znaleźliśmy kontaktowego adresu e-mail dla aplikacji <app-id>
. Odwiedź stronę Dystrybucja aplikacji w konsoli Firebase, aby go 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 udostępniania wielokrotnie napotykasz błędy 400, 409 lub 500, skontaktuj się z pomocą techniczną Firebase . Zapewnij pomoc techniczną, podając numer projektu Firebase i identyfikator aplikacji.
Sprawdź rozmiar pliku APK. Maksymalny limit rozmiaru pliku dla wszystkich plików binarnych wynosi 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 następujących poleceń:
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 App Distribution, Google Play automatycznie rezygnuje z wygenerowanego pliku APK, korzystając z certyfikatu klucza podpisywania aplikacji testowej. Po wyświetleniu monitu musisz zarejestrować swoją aplikację u dostawców API, jeśli chcesz nadal korzystać z ich usług stron trzecich. Po podpisaniu certyfikat testowy aplikacji można wyświetlić w konsoli Firebase.
Kompilacje AAB przesłane do App Distribution nie pojawiają się na Twoim koncie programisty w 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, wydarzy się co następuje:
Nie będziesz mieć możliwości przesyłania nowych pakietów aplikacji do App Distribution i eksportowania ich do Google Play poprzez integrację App Distribution z Google Play.
Istniejące kompilacje będą nadal dostępne w panelu dystrybucji aplikacji Firebase i dla testerów.
Wszelkie dane wyeksportowane wcześniej między Firebase i Google Play pozostaną dostępne w obu produktach.
Aby dystrybuować pakiet aplikacji na Androida (AAB) za pośrednictwem App Distribution 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 w 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.
Zarówno aplikacja w Google Play, jak i aplikacja Firebase na Androida są zarejestrowane przy użyciu tej samej nazwy pakietu.
Aplikację w Google Play konfiguruje się na panelu aplikacji i dystrybuuje do jednej ze ścieżek Google Play (testy wewnętrzne, testy zamknięte, testy otwarte lub produkcja).
Zakończono sprawdzanie aplikacji w Google Play i opublikowano ją. Twoja aplikacja została 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łałeś aplikację, która wcześniej nie spełniała powyższych kryteriów łączenia, ale teraz tak się dzieje, możesz spróbować ponownie 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 mogą napotkać testerzy podczas instalowania i testowania aplikacji.
Kiedy użytkownik tworzy konto Google, automatycznie otrzymuje adres Gmail.
Jeśli tester nie ma adresu Google Workspace ani Gmaila albo woli do logowania się użyć innego adresu e-mail, poproś testera o powiązanie z kontem adresu e-mail innego niż Gmail i używanie tego adresu e-mail do logowania.
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ż powiązany z innym kontem Google.
- Pamiętaj, aby używać hasła do konta Google podczas logowania się z tym adresem e -mail.
Aby uzyskać więcej informacji, zobacz Zaloguj się na swoje konto Google za pomocą innego adresu e -mail .
Jeśli tester zaakceptował zaproszenie e -mail z innym adresem e -mail niż wysłano zaproszenie, tester może nie być w stanie zobaczyć odpowiednich aplikacji lub kompilacji.
E -mail, do którego programista wysyła zaproszenia i dodaje do nowych kompilacji (e -mail a) może różnić się od e -maila, którego tester używa do przyjęcia zaproszenia (e -mail B). To tworzy link za kulisami. Ilekroć e -mail A jest dodawany do nowych kompilacji, w rzeczywistości e -mail B ma dostęp.
Jeśli tester zaakceptował zaproszenie e -mail z innym adresem e -mail, wykonaj następujące kroki, aby rozwiązać problem:
Usuń tester z sekcji Widok wszystkie testery karty Testerów i Grupy na stronie dystrybucji aplikacji konsoli Firebase. Istniejące zaproszenia są usuwane.
Ponownie zintegnij tester, aby przetestować aplikację. Tester powinien otrzymać wiadomość e -mail z zaproszeniem.
Upewnij się, że tester przyjmuje zaproszenie z tym samym adresem e -mail.
Testerzy mogą nie otrzymywać powiadomień e -mail, jeśli wystąpi jeden z poniższych:
Powiadomienia e -mail są wysyłane do folderów spamowych.
Filtry e -mail są ustawione.
Zaproszenie zostało wysłane na jedno konto e -mail, ale tester zaakceptowany za pomocą innego konta e -mail. Tester otrzymuje nowe e -maile z wydania na konto e -mail, na które zaproszenie zostało pierwotnie wysłane.
Tester został wcześniej zaproszony, ale nie zaakceptował wstępnego zaproszenia. Jeśli tester zostanie dodany do kolejnych wydań, dystrybucja aplikacji nie wysyła automatycznie powiadomień o wydaniach do tego testera, ponieważ tester nie zaakceptował początkowego zaproszenia.
Rozwiązanie 1
Poproś testera, aby sprawdził folder spamowy i wszelkie filtry e -mail, które ustawiają w swojej usłudze e -mail.
Jeśli tester zrezygnował z 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 e -mail na dole i kliknij umożliwić e -maile na ponowne subskrypcję.
Rozwiązanie 2
Jeśli tester nie chce powiadomień e -mail, ale chce być w stanie przyjąć zaproszenia do aplikacji, może przeglądać oczekujące zaproszenia do aplikacji bezpośrednio w aplikacji Tester App ( instrukcje pobierania ).
Rozwiązanie 3
Usuń tester z sekcji Widok wszystkie testery karty Testerów i Grupy na stronie dystrybucji aplikacji w konsoli Firebase. Ta akcja usuwa istniejące zaproszenia.
Ponownie zintegnij tester, aby przetestować aplikację. Tester powinien otrzymać wiadomość e -mail z zaproszeniem. Upewnij się, że Tester przyjmuje zaproszenie z tym samym adresem e -mail, na który zaproszenie zostało wysłane.
Jeśli tester pobiera i instaluje 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 pasuje do identyfikatora pakietu aplikacji FireBase, której użyłeś do przesłania dystrybucji.
Alert Android pojawia się, jeśli uruchomiona aplikacja lub przeglądarka nie otrzymała jeszcze zgody na instalację aplikacji poza Google Play. Udzielić pozwolenia:
Wersja Androida 8 lub nowsza : W aplikacji Ustawienia dotknij Zezwalaj z tego źródła .
Wersja Androida 7 lub wcześniejsza : w aplikacji Ustawienia , dotknij bezpieczeństwa i wybierz nieznane źródła . Gdy pojawi się monit, dotknij OK > Zaufaj .
Jeśli testowy APK nie instaluje się na urządzeniu testera:
- Sprawdź, czy certyfikaty w nowej wersji pasują do tych w wersji zainstalowanej na urządzeniu testera. System Android pozwala aplikacji aktualizować tylko wtedy, gdy certyfikaty pasują. Aby dowiedzieć się więcej, zobacz rozważania dotyczące podpisywania .
- Upewnij się, że wersja systemu operacyjnego urządzenia testerowego jest obsługiwana przez aplikację (sprawdź
minSdkVersion
).
Jeśli aplikacja aplikacji Tester uniemożliwia zalogowanie się i przekierowanie z powrotem na ekran Signin, możesz korzystać z Google Workspace (wcześniej GSUITE), który zawiera ustawienia ograniczeń.
Aby usunąć ustawienia ograniczeń:
Na karcie Apps Twojego obszaru roboczego Google upewnij się, że dystrybucja aplikacji FireBase nie jest ustawiona na dostęp: zablokowany .
Na karcie usługi upewnij się, że platforma chmurowa jest nieograniczona.
Po usunięciu ustawień spróbuj ponownie zalogować się.
Ten błąd może nastąpić, gdy instalowana aplikacja jest konflikt z aplikacją już zainstalowaną na urządzeniu. Na przykład może to być inny wariant tej samej aplikacji o tej samej niestandardowej uprawnieniu lub nazwie ContentProvider .
Możesz poprosić testera o zebranie raportu o błędach natychmiast po doświadczeniu problemu, i sprawdzić raport, aby uzyskać więcej informacji na temat przyczyny. Tester musi usunąć wszelkie sprzeczne aplikacje przed zainstalowaniem nowej aplikacji.
Po napotkaniu błędu 403 oznacza to, że konto, którego używasz, nie ma pozwolenia na instalację i testowanie aplikacji. Dostęp jest określany przez administratora domeny Twojego konta w Google Workspace.
Jeśli uważasz, że powinieneś mieć zgodę na instalację i testowanie aplikacji, poproś administratora konta Google Workspace, aby zmienił ustawienia konta. Twój administrator powinien postępować zgodnie z instrukcjami zarządzania dostępem do usług, które nie są kontrolowane indywidualnie .
Jeśli masz wiele kont, spróbuj zalogować się za pomocą innego konta, które nie jest ograniczone do instalacji i testowania aplikacji.
Jeśli jesteś testerem po raz pierwszy, zobacz skonfigurowanie się jako tester .
Jeśli jesteś istniejącym testerem dystrybucji aplikacji i otrzymasz nowe urządzenie z Androidem do przetestowania, zamiast ponownie przejść przez cały nowy przepływ testera, wykonaj te kroki:
Przejdź do appDistribution.firebase.google.com na urządzeniu z Androidem.
Zaloguj się za pomocą istniejącego konta testera i kliknij przycisk Pobierz aplikację Tester na dole ekranu, aby zainstalować aplikację do testera aplikacji Android.
Włączanie funkcji testera z dystrybucją aplikacji Android SDK
Skorzystaj z poniższych wskazówek, aby rozwiązywać problemy związane z włączaniem nowych powiadomień kompilacji w aplikacji lub przesyłania informacji zwrotnych w aplikacji za pomocą dystrybucji aplikacji Android SDK.
Jeśli już skonfigurujesz dystrybucję aplikacji SDK w aplikacji, aby obsługiwać informacje zwrotne w aplikacji, a twoi testerzy nie są w stanie przesłać informacji zwrotnej, wykonaj następujące kroki:
Włącz rejestrowanie w pełni dystrybucji aplikacji Android SDK w aplikacji:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
Sprawdź komunikaty o błędach w dziennikach aplikacji, filtrując „FireBaseAppDistribution”.
Potwierdź, że tester ma dostęp do zainstalowanej wersji:
Jeśli dzienniki wskazują, że „tester nie ma dostępu do tego zasobu”, twój tester mógł nie zostać zaproszony do aplikacji lub może nie mieć dostępu do wydania.
W pulpicie pulpitu rozkładu aplikacji w konsoli FireBase znajdź dokładną wersję, która działa na urządzeniu testera i upewnij się, że tester jest wymieniony na karcie Testerów na karcie wydania i jest w stanie przyjętym.
Jeśli nadal nie otrzymujesz informacji zwrotnej, wykonaj następujące kroki:
Na urządzeniu testowym zaloguj się do dystrybucji aplikacji FireBase za pomocą App Tester lub w aplikacji Tester Web. Pamiętaj, aby wybrać konto Google, które po raz pierwszy użyłeś po przyjęciu zaproszenia do przetestowania aplikacji.
Ponownie zainstaluj aplikację za pomocą aplikacji tester lub testowej aplikacji internetowej, aby upewnić się, że tester ma dostęp do wydania.
Spróbuj podać opinie, ponownie upewnij się, że zaloguj się z tym samym konto Google.
Upewnij się, że włączyłeś interfejs API Testerów aplikacji FireBase. Aby uzyskać więcej informacji, zobacz API włączania testera dystrybucji aplikacji .
Zgodnie z kluczowymi ograniczeniami upewnij się, że interfejs API Testerów aplikacji FireBase znajduje się na liście dozwolonych interfejsów API.
Jeśli zobaczysz tę wiadomość podczas przesyłania informacji zwrotnej, „wysłałby opinię, ale nie spowodowałby trybu rozwoju”, wyłącz tryb programisty na urządzeniu, uruchamiając to polecenie:
adb shell setprop debug.firebase.appdistro.devmode false
Sprawdź swój plik
google-services.json
, aby upewnić się, że przesyłasz opinię dla prawidłowego projektu i aplikacji.Włącz rejestrowanie w pełni dystrybucji aplikacji Android SDK w aplikacji:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
Sprawdź komunikaty o błędach w dziennikach aplikacji, filtrując „FireBaseAppDistribution”.
Jeśli skonfigurowałeś już dystrybucję aplikacji Android SDK w aplikacji, a testerzy nie otrzymują powiadomień w aplikacji, postępuj zgodnie z tymi krokami:
Sprawdź komunikaty o błędach, dołączając
OnFailureListener
do zadania zwróconego przez interfejs API dystrybucji aplikacji FireBase.Jawa
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> { if (e instanceof FirebaseAppDistributionException) { // Log exception here }});
Kotlina
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, zobacz 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, twój tester może nie być jeszcze powiązany z nową wersją.
W pulpicie pulpitu rozkładu aplikacji w konsoli Firebase upewnij się, że tester jest zawarty w dystrybucji kompilacji i jest w stanie zaakceptowanym .
Jeśli twój tester nadal nie otrzymuje powiadomień, poproś o to, aby śledzić poniższe wskazówki, aby upewnić się, że przyjęli zaproszenie do testowania aplikacji i że prawidłowo skonfigurowali urządzenie testujące:
Na urządzeniu testowym zaloguj się do dystrybucji aplikacji FireBase za pośrednictwem aplikacji lub za pośrednictwem aplikacji internetowej Tester. Pamiętaj, aby wybrać konto Google, którego po raz pierwszy użyłeś po przyjęciu zaproszenia do przetestowania aplikacji.
Sprawdź, czy nowa wersja aplikacji jest dostępna w App Tester lub w aplikacji Tester Web.
Domyślnie twoi testerzy muszą tylko raz zalogować się na swoje konto Google, aby włączyć funkcje testowania. Jeśli twoi testerzy są poproszeni 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ź, aby upewnić się, że włączałeś interfejs API Testerów aplikacji FireBase. Aby uzyskać więcej informacji, zobacz API włączania testera dystrybucji aplikacji .
Zgodnie z kluczowymi ograniczeniami upewnij się, że interfejs API Testerów aplikacji FireBase znajduje się na liście dozwolonych interfejsów API.
Jeśli zazwyczaj wyczyścisz shifedPreferences na Logout, możesz wyczyścić stan testera. Dystrybucja aplikacji przechowuje flagę, która wskazuje, czy twój tester już zalogował się do aplikacji. Aby uzyskać więcej informacji, zobacz repozytorium GitHub .
Często Zadawane Pytania
Dystrybucja aplikacji Firebase ma następujące limity testera:
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 wzrost limitu bez kosztów.
Testerzy mają 30 dni na przyjęcie zaproszenia do przetestowania aplikacji, zanim wygaśnie. Gdy do wygaśnięcia zaproszenia pozostało 5 dni, w konsoli Firebase obok testera w wersji pojawi się powiadomienie o wygaśnięciu. Zaproszenie można przedłużyć, ponownie za pośrednictwem menu rozwijanego w wierszu testera.
Wydania aplikacji są usuwane z dystrybucji aplikacji, jeśli wystąpi jeden z następujących warunków:
- Wydanie aplikacji jest starsze niż 150 dni.
- Przekrocz limit wersji 1000 aplikacji, a wersja aplikacji jest starsza niż 1000 najnowszych wydań aplikacji.
Aby uzyskać więcej informacji, patrz Dystrybucja aplikacji obsługuje maksymalnie 1000 wydań .
Po osiągnięciu lub przekroczenia 150-dniowego limitu wygaśnięcia lub limicie wydania 1000, wydanie jest usuwane z deski rozdzielczej aplikacji i aplikacji Tester App App. Jeśli twój tester zainstalował wydanie, lokalna wersja aplikacji nadal działa.
Aby wersja aplikacji była dostępna dłużej, użyj jednego z następujących zaleceń:
- Zanim wydanie aplikacji wygasa lub przekroczy limit wydania, pobierz APK lub AAB i usuń wydanie z pulpitu rozkładu aplikacji. Następnie ponownie przesłać APK lub AAB jako nową kompilację do dystrybucji aplikacji.
- Pobierz wydanie i prześlij go do przechowywania w chmurze w celu archiwizacji długoterminowej.
Wydania aplikacji wygasają po 150 dniach
Po przesyłaniu wersji aplikacji do FireBase, wydanie pojawia się w pulpicie Dystrybucji aplikacji przez 150 dni, zaczynając od daty przesłania. Po przesłaniu wersji możesz rozpowszechniać ją do testerów, którzy instalują wersję z aplikacji Tester aplikacji FireBase na ich urządzeniu testującym.
Gdy wydanie trwa 30 dni od daty ważności, powiadomienie o wygaśnięciu aplikacji pojawia się w wydaniu w aplikacji Tester App.
Dystrybucja aplikacji obsługuje maksymalnie 1000 wydań
Dystrybucja aplikacji pozwala na maksymalnie 1000 wydań na aplikację. Gdy aplikacja osiągnie limit wersji 1000 aplikacji, dystrybucja aplikacji automatycznie usuwa najstarsze wydania powyżej limitu.
Jeśli chcesz ręcznie zarządzać wydawnictwem aplikacji, użyj interfejsu API REST Distribution Distribution, aby wymienić i usuwać aplikacje.
Jeśli masz pytania, skontaktuj się z wsparciem FireBase .
Jeśli jesteś testerem, zalecamy pobieranie testera aplikacji FireBase , aplikacji, która pozwala uzyskać dostęp do wszystkich kompilacji testów w jednym miejscu.
Aby usunąć konto testera dystrybucji aplikacji i powiązane dane, wykonaj następujące kroki w kolejności:
Odwiedź https://appdistribution.firebase.google.com i zaloguj się na swoim koncie Google.
W prawej górnej części kliknij
( zarządzaj kontem )Usuń konto .
Opcjonalnie: W uprawnieniach konta Google odwołuj dostęp z dystrybucji aplikacji FireBase. Pamiętaj, że cofnięcie dostępu bez uprzedniego usuwania konta dystrybucji aplikacji nie usuwa konta testera ani danych.