Rozwiązywanie problemów z dystrybucją aplikacji i często zadawane pytania

Nie można rozpowszechnić aplikacji z powodu braku kontaktowego adresu e-mail

Podczas przesyłania aplikacji może wystąpić ten błąd:

„Nie mogliśmy znaleźć kontaktowego adresu e-mail dla aplikacji <app-id> . Odwiedź sekcję Dystrybucja aplikacji w konsoli Firebase, aby ją skonfigurować”.

Ustaw kontaktowy adres e-mail w konsoli Firebase, jeśli jest dostępny. Jeśli problem będzie się powtarzał, skontaktuj się z pomocą techniczną Firebase .

Podczas obsługi administracyjnej Twojej aplikacji wystąpił błąd (błędy 400, 409 lub 500 )

Jeśli podczas obsługi administracyjnej wielokrotnie napotykasz błędy 400, 409 lub 500, skontaktuj się z pomocą techniczną Firebase . Podaj numer projektu Firebase i identyfikator aplikacji.

Nie można przesłać pliku APK

1. Sprawdź rozmiar pliku APK. Maksymalny limit rozmiaru pliku dla wszystkich plików binarnych to 2048 MiB, czyli nieco ponad 2 GB.

2. Jeśli rozmiar pliku APK mieści się w limicie rozmiaru pliku i można go odtworzyć, skontaktuj się z pomocą techniczną Firebase .

Nie można przesłać pliku APK za pomocą fastlane. Plik APK jest niepodpisany.

Sprawdź, czy plik APK jest podpisany przy użyciu:

apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk

Odbieranie błędów z logowaniem społecznościowym/zewnętrznymi dostawcami interfejsów API

Gdy przesyłasz plik AAB do dystrybucji aplikacji, Google Play automatycznie rezygnuje z wygenerowanego pliku APK przy użyciu certyfikatu klucza podpisywania aplikacji testowej. Po wyświetleniu monitu musisz zarejestrować swoją aplikację u dostawców interfejsów API, jeśli chcesz nadal korzystać z ich usług innych firm. Po podpisaniu certyfikat testowy aplikacji można wyświetlić w konsoli Firebase.

Czy przesłane przeze mnie AAB pojawiają się też w Google Play?

Kompilacje AAB, które przesyłasz do dystrybucji aplikacji, nie pojawiają się na Twoim koncie programisty Google Play (dotyczy to Eksploratora pakietu aplikacji i wewnętrznego udostępniania aplikacji).

Co się stanie, jeśli odłączę Firebase od Google Play?

Jeśli aplikacja Firebase na Androida zostanie odłączona od Google Play, dzieje się tak:

• Nie będzie można przesyłać nowych pakietów aplikacji do usługi App Distribution ani eksportować ich do Google Play za pośrednictwem integracji usługi App Distribution z Google Play.

• Istniejące kompilacje będą nadal dostępne w panelu Firebase App Distribution i dla Twoich testerów.

• Wszelkie dane wcześniej wyeksportowane między Firebase a Google Play pozostaną dostępne w obu usługach.

Czy mogę spróbować ponownie połączyć aplikację z Google Play?

Aby dystrybuować pakiet aplikacji na Androida (AAB) za pośrednictwem dystrybucji aplikacji i automatycznie łączyć przesłane pakiety AAB zarówno z projektem Firebase, jak i kontem programisty Google Play, upewnij się, że spełniasz następujące wymagania:

• Twoje konto programisty Google Play ma jeden z następujących poziomów dostępu : właściciel lub administrator.

• W projekcie Firebase masz jedną z następujących ról: Właściciel lub Administrator Firebase .

• Twoja aplikacja jest zarejestrowana w Firebase i na Twoim koncie programisty Google Play. Oznacza to, że masz zarówno aplikację Firebase na Androida, jak i aplikację Google Play.

• Aplikacja w Google Play i aplikacja Firebase na Androida są zarejestrowane przy użyciu tej samej nazwy pakietu.

• Aplikacja w Google Play jest konfigurowana na pulpicie nawigacyjnym aplikacji i jest dystrybuowana do jednej ze ścieżek Google Play (testy wewnętrzne, testy zamknięte, testy otwarte lub produkcja).

• Recenzja aplikacji w Google Play została zakończona i aplikacja została opublikowana. Twoja aplikacja jest opublikowana, jeśli w kolumnie Stan aplikacji wyświetlany jest jeden z następujących stanów: Testy wewnętrzne (nie Wersja robocza testów wewnętrznych), Testy zamknięte, Testy otwarte lub Produkcja.

Jeśli przesłana przez Ciebie aplikacja, która wcześniej nie spełniała powyższych kryteriów łączenia, a teraz spełnia, możesz ponownie spróbować połączyć swoją aplikację Firebase na Androida z Google Play .

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 albo woli użyć innego adresu e-mail do zalogowania się, poproś testera o powiązanie z kontem adresu e-mail innego niż Gmail i zalogowanie się przy użyciu tego adresu e-mail.

Wybierając alternatywny adres e-mail, tester musi przestrzegać następujących wskazówek:

• Nie używaj adresu Gmail.
• Nie używaj adresu e-mail, który jest już połączony z innym kontem Google.
• Pamiętaj, aby użyć hasła do konta Google podczas logowania za pomocą tego adresu e-mail.

Aby uzyskać więcej informacji, zobacz Logowanie się na konto Google przy użyciu innego adresu e-mail .

Tester nie widzi odpowiednich aplikacji lub kompilacji

Jeśli tester zaakceptował zaproszenie e-mail z innym adresem e-mail niż ten, na który zostało wysłane zaproszenie, tester może nie widzieć odpowiednich aplikacji lub kompilacji.

Adres e-mail, na który programista wysyła zaproszenia i które dodaje do nowych kompilacji (e-mail A), może różnić się od adresu e-mail, którego używa tester do zaakceptowania zaproszenia (e-mail B). To tworzy link za kulisami. Ilekroć e-mail A jest dodawany do nowych kompilacji, w rzeczywistości dostęp uzyskuje e-mail B.

Jeśli tester zaakceptował zaproszenie e-mail z innym adresem e-mail, wykonaj następujące czynności, aby rozwiązać problem:

1. Usuń testera z karty Testerzy i grupy na stronie Dystrybucja aplikacji w konsoli Firebase. Istniejące zaproszenia zostaną usunięte.

2. Ponownie zaproś testera do przetestowania Twojej aplikacji. Tester powinien otrzymać wiadomość e-mail z zaproszeniem.

3. Upewnij się, że tester akceptuje zaproszenie z tym samym adresem e-mail.

Tester nie otrzymuje powiadomień e-mail

Testerzy mogą nie otrzymywać powiadomień e-mail, jeśli wystąpi jedna z poniższych sytuacji:

• Powiadomienia e-mail są wysyłane do folderów ze spamem.

• Filtry e-maili są ustawione.

• Zaproszenie zostało wysłane na jedno konto e-mail, ale tester zaakceptował je za pomocą innego konta e-mail. Tester otrzymuje wiadomości e-mail z nowymi wersjami dla konta e-mail, na które pierwotnie wysłano zaproszenie.

• Tester został wcześniej zaproszony, ale nie przyjął pierwszego zaproszenia. Jeśli tester zostanie dodany do kolejnych wersji, usługa App Distribution nie będzie automatycznie wysyłać powiadomień o wydaniach do tego testera, ponieważ tester nie zaakceptował początkowego zaproszenia.

Rozwiązanie 1

1. Poproś testera o sprawdzenie folderu ze spamem i wszelkich filtrów e-mail ustawionych w jego usłudze e-mail.

2. Jeśli tester anulował subskrypcję e-maili, poproś testera o wykonanie następujących czynności:

   1. Znajdź wiadomość e-mail, którą tester otrzymał wcześniej z aplikacji.
   2. Kliknij Zarządzaj ustawieniami poczty e-mail u dołu i kliknij Zezwalaj na ponowną subskrypcję e-maili .

Rozwiązanie 2

1. Usuń testera z karty Testerzy i grupy na stronie Dystrybucja aplikacji w konsoli Firebase. Ta czynność usuwa istniejące zaproszenia.

2. Ponownie zaproś testera do przetestowania Twojej aplikacji. Tester powinien otrzymać wiadomość e-mail z zaproszeniem. Upewnij się, że tester akceptuje zaproszenie z tym samym adresem e-mail, na który zostało wysłane zaproszenie.

Aplikacja nie wskazuje, że aplikacja jest zainstalowana

Jeśli tester pobierze i zainstaluje wersję, ale interfejs użytkownika szczegółów aplikacji nie pokazuje, że aplikacja jest zainstalowana, jest to znany problem. W niektórych przypadkach identyfikator pakietu w aplikacji Firebase nie pasuje do identyfikatora pakietu APK.

Sprawdź, czy identyfikator pakietu APK jest zgodny z identyfikatorem pakietu aplikacji Firebase użytej do przesłania dystrybucji.

Alert Androida, który mówi, że moje urządzenie nie może instalować nieznanych aplikacji

Alert Androida pojawia się, jeśli uruchomiona aplikacja lub przeglądarka nie otrzymała jeszcze pozwolenia na instalowanie aplikacji spoza Google Play. Aby udzielić pozwolenia:

• Android w wersji 8 lub nowszej : w aplikacji Ustawienia kliknij Zezwól z tego źródła .

• Android w wersji 7 lub starszej : w aplikacji Ustawienia dotknij Zabezpieczenia i wybierz Nieznane źródła . Gdy pojawi się monit, dotknij OK > Zaufaj .

Nie można zainstalować testowych plików APK

Jeśli testowego pakietu APK nie można zainstalować na urządzeniu testera:

• Sprawdź, czy certyfikat(y) w nowej wersji są zgodne z wersją zainstalowaną na urządzeniu testera. System Android umożliwia aktualizację aplikacji tylko wtedy, gdy certyfikaty są zgodne. Aby dowiedzieć się więcej, zobacz Uwagi dotyczące podpisywania .
• Upewnij się, że aplikacja obsługuje wersję systemu operacyjnego testera (sprawdź minSdkVersion ).

Nie można zalogować się do aplikacji Android App Tester

Jeśli aplikacja App Tester uniemożliwia Ci zalogowanie się i przekierowuje z powrotem do ekranu logowania, być może korzystasz z Google Workspace (dawniej GSuite), który zawiera ustawienia ograniczeń.

Aby usunąć ustawienia ograniczeń:

1. Na karcie Aplikacje w Google Workspace upewnij się, że Dystrybucja aplikacji Firebase nie jest ustawiona na Dostęp: zablokowany .

2. Na karcie Usługi upewnij się, że usługa Cloud Platform jest nieograniczona.

3. Po usunięciu ustawień spróbuj zalogować się ponownie.

Błąd podczas instalacji AAB: „Nie można zainstalować aplikacji”

Ten błąd może wystąpić, gdy instalowana aplikacja powoduje konflikt z aplikacją już zainstalowaną na urządzeniu. Może to być na przykład inny wariant tej samej aplikacji z tym samym niestandardowym uprawnieniem lub nazwą ContentProvider .

Możesz poprosić testera o zebranie raportu o błędzie natychmiast po wystąpieniu problemu i przejrzenie raportu, aby uzyskać więcej informacji o przyczynie. Tester musi usunąć wszelkie aplikacje powodujące konflikt, zanim będzie można zainstalować nową aplikację.

Błąd 403: „Skontaktuj się z administratorem w celu uzyskania dostępu”

Gdy napotkasz błąd 403, oznacza to, że konto, którego używasz, nie ma uprawnień do instalowania i testowania aplikacji. Dostęp jest określany przez administratora domeny Twojego konta w Google Workspace.

Jeśli uważasz, że powinieneś mieć uprawnienia do instalowania i testowania aplikacji, poproś administratora konta Google Workspace o zmianę ustawień konta. Administrator powinien postępować zgodnie z instrukcjami w artykule Zarządzanie dostępem do usług, które nie są kontrolowane indywidualnie .

Jeśli masz wiele kont, spróbuj zalogować się przy użyciu innego konta, które nie ma ograniczeń dotyczących instalowania i testowania aplikacji.

Tester nie otrzymuje alertów w aplikacji

Jeśli masz już skonfigurowany pakiet App Distribution Android SDK w swojej aplikacji, a Twoi testerzy nie otrzymują alertów w aplikacji, wykonaj następujące kroki:

1. Sprawdź komunikaty o błędach, dołączając OnFailureListener do zadania zwróconego przez interfejs Firebase App Distribution API.

   Jawa

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> {
                     if (e instanceof FirebaseAppDistributionException) {
                        // Log exception here
                     }});
   

   Kotlin

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e ->
                     if (e is FirebaseAppDistributionException) {
                        // Log exception here
                     }
     }
   

2. Sprawdź, czy tester ma dostęp do nowej wersji:

   1. Włącz tryb debugowania w swojej aplikacji. Aby dowiedzieć się, jak to zrobić, zapoznaj się z dokumentacją Google Analytics .

   2. Uruchom aplikację w symulatorze i wyszukaj ciąg „FirebaseAppDistribution”.

      Jeśli dzienniki wskazują, że nie znaleziono żadnej wersji lub że tester nie ma dostępu, tester może nie być jeszcze powiązany z nową wersją.

   3. Na pulpicie nawigacyjnym Dystrybucja aplikacji w konsoli Firebase upewnij się, że tester jest uwzględniony w Twojej dystrybucji kompilacji i ma stan Zaakceptowany .

      Jeśli tester nadal nie otrzymuje alertów, poproś go o wykonanie poniższych wskazówek, aby upewnić się, że zaakceptował zaproszenie do przetestowania Twojej aplikacji i prawidłowo skonfigurował swoje urządzenie testowe:

      1. Na urządzeniu testowym zaloguj się do usługi Firebase App Distribution za pomocą testera aplikacji lub aplikacji internetowej testera. Pamiętaj, aby wybrać konto Google użyte po raz pierwszy, kiedy zaakceptowałeś zaproszenie do przetestowania aplikacji.

      2. Sprawdź, czy nowa wersja aplikacji jest dostępna w Testerze aplikacji lub w aplikacji internetowej testera.

Tester poprosił o ponowne zalogowanie się po zamknięciu aplikacji

Domyślnie Twoi testerzy muszą tylko raz zalogować się na swoje konto Google, aby włączyć nowe aktualizacje kompilacji i zainstalować nowe kompilacje. Jeśli testerzy są proszeni o ponowne zalogowanie się po zamknięciu i ponownym otwarciu aplikacji, postępuj zgodnie z tymi wskazówkami, aby upewnić się, że konfiguracja dystrybucji aplikacji jest prawidłowo skonfigurowana:

• Sprawdź, czy masz włączony interfejs Firebase App Testers API. Aby uzyskać więcej informacji, zobacz Włączanie interfejsu API testera dystrybucji aplikacji .

• W obszarze Kluczowe ograniczenia upewnij się, że interfejs Firebase App Testers API znajduje się na liście dozwolonych interfejsów API.

• Jeśli zazwyczaj czyścisz SharedPreferences przy wylogowaniu, być może czyścisz stan swojego testera. Dystrybucja aplikacji przechowuje flagę wskazującą, czy tester zalogował się już do aplikacji. Aby uzyskać więcej informacji, zobacz repozytorium GitHub .

Czy istnieją ograniczenia dotyczące dodawania testerów do mojej aplikacji?

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 .

Czy moje zaproszenia dla testerów wygasają?

Testerzy mają 30 dni na zaakceptowanie zaproszenia do przetestowania aplikacji przed jego wygaśnięciem. Gdy zaproszenie wygaśnie za 5 dni, w konsoli Firebase obok testera pojawi się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie za pomocą menu rozwijanego w wierszu testera.

Jak długo dostępne są wersje aplikacji?

Wersje aplikacji są usuwane z usługi Dystrybucja aplikacji, jeśli spełniony jest jeden z następujących warunków:

• Wersja aplikacji jest starsza niż 150 dni.
• Przekraczasz limit 1000 wersji aplikacji, a wersja aplikacji jest starsza niż 1000 najnowszych wersji aplikacji.

Aby uzyskać więcej informacji, zobacz Dystrybucja aplikacji obsługuje maksymalnie 1000 wydań .

Gdy aplikacja osiągnie lub przekroczy 150-dniowy limit wygaśnięcia lub limit 1000 wersji, wersja zostanie usunięta z pulpitu dystrybucji aplikacji i aplikacji Firebase App Tester. Jeśli tester zainstalował tę wersję, lokalna wersja aplikacji nadal działa.

Aby wersja aplikacji była dłużej dostępna, skorzystaj z jednej z poniższych rekomendacji:

• Zanim wersja aplikacji wygaśnie lub przekroczy limit wersji, pobierz plik APK lub AAB i usuń wersję z pulpitu dystrybucji aplikacji. Następnie ponownie prześlij plik APK lub AAB jako nową kompilację do dystrybucji aplikacji.
• Pobierz wersję i prześlij ją do Cloud Storage w celu długoterminowej archiwizacji.

Wersje aplikacji wygasają po 150 dniach

Gdy prześlesz wersję swojej aplikacji do Firebase, pojawi się ona w panelu dystrybucji aplikacji przez 150 dni, licząc od daty przesłania. Po przesłaniu wersji możesz ją rozesłać do testerów, którzy zainstalują ją z aplikacji Firebase App Tester na swoim urządzeniu testowym.

Gdy upłynie 30 dni od daty wygaśnięcia wersji, na Twojej wersji w aplikacji Firebase App Tester pojawi się powiadomienie o wygaśnięciu wersji.

Dystrybucja aplikacji obsługuje maksymalnie 1000 wydań

Dystrybucja aplikacji zezwala na maksymalnie 1000 wydań na aplikację. Kiedy Twoja aplikacja osiągnie limit 1000 wydań aplikacji, Dystrybucja aplikacji automatycznie usunie najstarsze wydania przekraczające ten limit.

Jeśli chcesz ręcznie zarządzać wersjami aplikacji, użyj interfejsu API REST dystrybucji aplikacji, aby zbiorczo wyświetlać i usuwać wersje aplikacji.

Jeśli masz pytania, skontaktuj się z pomocą techniczną Firebase .

Jak mogę uzyskać dostęp do aplikacji testowych zainstalowanych na moim urządzeniu?

Jeśli jesteś testerem, zalecamy pobranie Firebase App Tester , aplikacji, która umożliwia dostęp do wszystkich kompilacji testowych w jednym miejscu.

Jak usunąć moje konto testera?

Aby usunąć konto testera dystrybucji aplikacji i powiązane z nim dane, wykonaj następujące kroki w podanej kolejności:

1. Odwiedź https://appdistribution.firebase.google.com i zaloguj się na swoje konto Google.

2. W prawym górnym rogu kliknij settings ( Zarządzaj kontem )

   Usuń konto .

3. Opcjonalnie: w uprawnieniach swojego konta Google anuluj dostęp Firebase App Distribution. Pamiętaj, że cofnięcie dostępu bez uprzedniego usunięcia konta App Distribution nie powoduje usunięcia konta ani danych testera.