Rozwiązywanie problemów z Rozpowszechnianiem aplikacji & Najczęstsze pytania

Nie można rozpowszechniać aplikacji z powodu braku adresu e-mail do kontaktu

Podczas przesyłania aplikacji możesz napotkać ten błąd:

„Nie udało nam się znaleźć adresu e-mail do kontaktu z twórcą aplikacji <app-id>. Aby go skonfigurować, otwórz App Distribution w konsoli Firebase.

W konsoli Firebase ustaw kontaktowy adres e-mail (jeśli jest dostępny). Jeśli problem będzie się powtarzał, skontaktuj się z zespołem pomocy Firebase.

Podczas udostępniania aplikacji wystąpił błąd (błędy 400, 409 lub 500)

Jeśli podczas udostępniania wielokrotnie występują błędy 400, 409 lub 500, skontaktuj się z zespołem pomocy Firebase. Podaj zespołowi pomocy numer projektu Firebase i identyfikator aplikacji.

Nie udało się przesłać pliku APK

1. Sprawdź rozmiar pliku APK. Maksymalny rozmiar pliku binarnego to 2048 MiB, czyli nieco ponad 2 GB.

2. Jeśli rozmiar pliku APK mieści się w limitach i można go odtworzyć, skontaktuj się z zespołem pomocy Firebase.

Nie udało się przesłać pliku APK za pomocą fastlane. Plik APK jest niepodpisany.

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

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

Błędy związane z logowaniem się przez media społecznościowe lub zewnętrznymi dostawcami interfejsu API

Gdy prześlesz plik AAB do App Distribution, Google Play automatycznie ponownie podpisze wygenerowany plik APK za pomocą testowego certyfikatu klucza podpisywania aplikacji. Jeśli chcesz nadal korzystać z ich usług, musisz zarejestrować aplikację u dostawców interfejsów API. Po podpisaniu certyfikat testowy aplikacji można wyświetlić w konsoli Firebase.

Czy 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ę Firebase od Google Play?

Jeśli aplikacja Firebase na Androida zostanie odłączona od Google Play:

• nie będziesz mieć możliwości przesyłania nowych pakietów aplikacji do usługi App Distribution ani eksportowania ich do Google Play przez integrację z tą usługą;App Distribution

• Istniejące wersje będą nadal dostępne w panelu Firebase App Distribution oraz dla testerów.

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

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

Aby rozpowszechniać pakiet aplikacji na Androida (AAB) w usłudze App Distribution i automatycznie łączyć przesłane pakiety AAB z projektem Firebase oraz kontem dewelopera w Google Play, musisz spełnić te wymagania:

• Twoje konto dewelopera w Google Play ma jeden z tych poziomów dostępu: Właściciel lub Administrator.

• W projekcie Firebase masz jedną z tych ról: Właściciel lub Administrator Firebase.

• Aplikacja jest zarejestrowana w Firebase oraz na koncie dewelopera w Google Play. Oznacza to, że masz zarówno aplikację Firebase na Androida, jak i aplikację Google Play.

• Zarówno aplikacja w Google Play, jak i aplikacja Firebase na Androida zostały zarejestrowane przy użyciu tej samej nazwy pakietu.

• Aplikacja w Google Play jest skonfigurowana w panelu aplikacji i rozpowszechniana na jednej ze ścieżek Google Play (test wewnętrzny, test zamknięty, test otwarty i produkcja).

• Zakończono sprawdzanie aplikacji w Google Play i aplikacja została opublikowana. Aplikacja jest opublikowana, jeśli w kolumnie Stan aplikacji widoczny jest jeden z tych stanów: Test wewnętrzny (nie wersja robocza testu wewnętrznego), Test zamknięty, Test otwarty lub Produkcja.

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

Tester nie ma konta Google

Gdy użytkownik tworzy konto Google, automatycznie otrzymuje adres Gmail.

Jeśli tester nie ma adresu Google Workspace ani Gmaila lub woli zalogować się przy użyciu innego adresu e-mail, poproś go o połączenie z kontem adresu e-mail spoza Gmaila i używanie go do logowania.

Wybierając alternatywny adres e-mail, tester musi przestrzegać tych wytycznych:

• Nie używaj adresu Gmail.
• Nie używaj adresu e-mail, który jest już połączony z innym kontem Google.
• Pamiętaj, że musisz podawać hasło do konta Google, gdy logujesz się przy użyciu tego adresu e-mail.

Więcej informacji znajdziesz w artykule Logowanie się na konto Google przy użyciu innego adresu e-mail.

Tester nie widzi odpowiednich aplikacji lub kompilacji

Jeśli tester zaakceptuje zaproszenie e-mail z innego adresu e-mail niż ten, na który zostało wysłane, może nie widzieć odpowiednich aplikacji ani wersji.

Adres e-mail, na który deweloper wysyła zaproszenia i dodaje nowe wersje (adres A), może być inny niż adres e-mail, którego tester używa do akceptowania zaproszenia (adres B). Spowoduje to utworzenie linku w tylu. Gdy e-mail A zostaje dodany do nowych wersji, dostęp uzyskuje e-mail B.

Jeśli tester zaakceptował e-maila z zaproszeniem, korzystając z innego adresu e-mail, wykonaj te czynności, aby rozwiązać problem:

1. 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.

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

3. Upewnij się, że tester zaakceptuje zaproszenie z tego samego adresu e-mail.

Testerzy nie otrzymują e-maili z powiadomieniami

Testerzy mogą nie otrzymywać powiadomień e-mail, jeśli wystąpi jedno z tych zdarzeń:

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

• Filtry e-maili są ustawione.

• Zaproszenie zostało wysłane na jeden adres e-mail, ale tester zaakceptował je z innego adresu e-mail. Tester otrzymuje e-maile z informacjami o nowych wersjach na konto e-mail, na które zostało wysłane pierwotne zaproszenie.

• Tester został wcześniej zaproszony, ale nie zaakceptował 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

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

2. Jeśli tester anulował subskrypcję e-maili, poproś go o wykonanie tych czynności:

   1. Znajdź e-maila, który tester otrzymał wcześniej od aplikacji.
   2. Aby ponownie zasubskrybować kanał, u dołu kliknij Zarządzaj ustawieniami poczty e-mail, a potem kliknij Zezwalaj na wysyłanie e-maili.

Rozwiązanie 2

Jeśli tester nie chce otrzymywać powiadomień e-mail, ale chce akceptować zaproszenia do aplikacji, może wyświetlić oczekujące zaproszenia bezpośrednio w aplikacji App Tester (instrukcje pobierania).

Rozwiązanie 3

1. 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ń.

2. Ponownie zaproś testera do przetestowania aplikacji. Tester powinien otrzymać e-maila z zaproszeniem. Upewnij się, że tester zaakceptuje zaproszenie z tego samego adresu e-mail, na który zostało wysłane.

Aplikacja nie wskazuje, że jest zainstalowana

Jeśli tester pobierze i zainstaluje wersję, ale interfejs z informacjami o aplikacji nie będzie wskazywał, że aplikacja jest zainstalowana, 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 pliku APK jest zgodny z identyfikatorem pakietu aplikacji Firebase, której użyto do przesłania dystrybucji.

Alert na Androidzie, że na urządzeniu nie można instalować nieznanych aplikacji

Alert na Androidzie pojawia się, jeśli uruchomiona aplikacja lub przeglądarka nie ma jeszcze uprawnień do instalowania aplikacji spoza Google Play. Aby przyznać uprawnienia:

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

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

Nie udaje się zainstalować testowych plików APK

Jeśli nie uda się zainstalować testowego pliku APK na urządzeniu testera:

• Sprawdź, czy certyfikaty w nowej wersji są zgodne z certyfikatami w wersji zainstalowanej na urządzeniu testera. System Android pozwala na aktualizację aplikacji tylko wtedy, gdy certyfikaty są zgodne. Więcej informacji znajdziesz w uwagach dotyczących podpisywania.
• Upewnij się, że aplikacja obsługuje wersję systemu operacyjnego urządzenia testera (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ń:

1. Na karcie Aplikacje w Google Workspace sprawdź, czy Firebase App Distribution nie ma ustawioną opcję Dostęp: zablokowany.

2. Na karcie Usługi sprawdź, czy Cloud Platform nie jest ograniczona.

3. Gdy usuniesz ustawienia, spróbuj się zalogować ponownie.

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

Ten błąd może wystąpić, gdy instalowana aplikacja wchodzi w konflikt z aplikacją już zainstalowaną na urządzeniu. Może to być na przykład inna wersja tej samej aplikacji z tymi samymi niestandardowymi uprawnieniami lub nazwą ContentProvider.

Możesz poprosić testera o zebranie raportu o błędzie natychmiast po wystąpieniu problemu i zapoznanie się z dodatkowymi informacjami o jego przyczynie. Zanim tester zainstaluje nową aplikację, musi usunąć wszystkie aplikacje, które się z nią pokrywają.

Błąd 403: „Aby uzyskać dostęp, skontaktuj się z administratorem”

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

Jeśli uważasz, że przysługuje Ci uprawnienie do instalowania i testowania aplikacji, poproś administratora konta Google Workspace o zmianę ustawień konta. Administrator powinien wykonać instrukcje podane w artykule Zarządzanie dostępem do usług, które nie mają własnych opcji włączania i wyłączania.

Jeśli masz kilka kont, spróbuj zalogować się na inne konto, na którym nie obowiązują ograniczenia dotyczące instalowania i testowania aplikacji.

Testowanie na nowym urządzeniu z Androidem

Jeśli testujesz po raz pierwszy, przeczytaj artykuł Konfigurowanie funkcji testowania.

Jeśli jesteś testerem App Distribution i masz nowe urządzenie z Androidem, na którym chcesz przeprowadzić testy, zamiast przechodzić przez cały proces testowania, wykonaj te czynności:

1. Na urządzeniu z Androidem otwórz stronę appdistribution.firebase.google.com.

2. Zaloguj się na swoje konto testera i u dołu ekranu kliknij przycisk Pobierz aplikację Testerzy, aby zainstalować aplikację Testerzy aplikacji na Androida.

Tester nie może rozpocząć przesyłania opinii w aplikacji

Jeśli w swojej aplikacji masz już skonfigurowany pakiet SDK Androida App Distribution, aby umożliwić przesyłanie opinii w aplikacji, a Twoi testerzy nie mogą tego zrobić, wykonaj te czynności:

1. Włącz szczegółowe logowanie w pakiecie SDK Androida App Distribution w swojej aplikacji:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

2. Sprawdź, czy w dziennikach aplikacji nie ma komunikatów o błędach. Aby to zrobić, zastosuj filtr „FirebaseAppDistribution”.

3. Sprawdź, czy tester ma dostęp do zainstalowanej wersji:

   1. 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.

   2. W panelu App Distribution w konsoli Firebase znajdź dokładną wersję, która jest uruchomiona na urządzeniu testera, i upewnij się, że tester jest wymieniony na karcie wersji na karcie Testerzy i ma stan „Zaakceptowano”.

   Jeśli nadal nie otrzymujesz opinii, wykonaj te czynności:

   1. Na urządzeniu testowym zaloguj się w aplikacji App Tester lub w aplikacji internetowej testera. Pamiętaj, aby wybrać konto Google, którego użyto po raz pierwszy, gdy akceptowano zaproszenie do testowania aplikacji.Firebase App Distribution

   2. Zainstaluj aplikację ponownie za pomocą Testera aplikacji lub testowej aplikacji internetowej, aby sprawdzić, czy tester ma dostęp do wersji.

   3. Spróbuj przesłać opinię, ponownie logując się na to samo konto Google.

4. Upewnij się, że masz włączony interfejs API Testerzy aplikacji Firebase. Więcej informacji znajdziesz w artykule Włączanie interfejsu API Testera dystrybucji aplikacji.

5. W sekcji Ograniczenia klucza sprawdź, czy interfejs API Testerzy aplikacji Firebase znajduje się na liście dozwolonych interfejsów API.

Nieotrzymywanie opinii przesłanych w aplikacji

1. Jeśli podczas przesyłania opinii zobaczysz komunikat „Nie udało się przesłać opinii ze względu na tryb deweloperski”, wyłącz tryb deweloperski na urządzeniu, wykonując ten polecenie:

   adb shell setprop debug.firebase.appdistro.devmode false
   

2. Sprawdź plik google-services.json, aby mieć pewność, że przesyłasz opinię dotyczącą właściwego projektu i aplikacji.

3. Włącz szczegółowe logowanie w pakiecie SDK Androida App Distribution w swojej aplikacji:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

4. Sprawdź, czy w dziennikach aplikacji nie ma komunikatów o błędach. Aby to zrobić, zastosuj filtr „FirebaseAppDistribution”.

Testerzy nie otrzymują powiadomień w aplikacji

Jeśli pakiet SDK do Androida App Distribution jest już skonfigurowany w aplikacji, a testerzy nie otrzymują alertów w aplikacji, wykonaj te czynności:

1. 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
                     }
     }
   

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

   1. Włącz tryb debugowania w aplikacji. Więcej informacji znajdziesz w dokumentacji Google Analytics.

   2. Uruchom aplikację w symulatorze i poszukaj ciągu znaków „FirebaseAppDistribution”.

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

   3. 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:

      1. 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.

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

po zamknięciu aplikacji testerowi wyświetla się prośba o ponowne zalogowanie się.

Domyślnie testerzy muszą zalogować się na swoje konto Google tylko raz, aby włączyć funkcje testowania. Jeśli po zamknięciu i ponowym otwarciu aplikacji testerzy otrzymują prośbę o ponowne zalogowanie, wykonaj te czynności, aby sprawdzić, czy konfiguracja App Distribution jest prawidłowo skonfigurowana:

• Sprawdź, czy masz włączony interfejs API Testerzy aplikacji Firebase. Więcej informacji znajdziesz w artykule Włączanie interfejsu App Distribution Tester API.

• W sekcji Ograniczenia klucza sprawdź, czy interfejs API Testerzy aplikacji Firebase znajduje się na liście dozwolonych interfejsów API.

• Jeśli zwykle po wylogowaniu usuwasz SharedPreferences, możesz usuwać stan testera. App Distribution przechowuje flagę wskazującą, czy Twój tester zalogował się już w aplikacji. Więcej informacji znajdziesz w repozytorium GitHub.

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

Firebase App Distribution ma te limity testerów:

• Dodawanie maksymalnie 500 testerów do projektu Firebase

• Do grupy App Distribution możesz dodać maksymalnie 200 testerów

Aby dodać więcej testerów, poproś o bezpłatne zwiększenie limitu.

Czy zaproszenia dla testerów wygasają?

Testerzy mają 30 dni na zaakceptowanie zaproszenia do testowania aplikacji, zanim utraci ono ważność. Gdy do wygaśnięcia zaproszenia pozostaną 5 dni, w konsoli Firebase obok testera w ramach wersji pojawi się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie za pomocą menu w wierszu testującego.

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

Wersje aplikacji są usuwane z App Distribution, jeśli spełniony jest jeden z tych warunków:

• Wersja aplikacji jest starsza niż 150 dni.
• Osiągnięto limit 1000 wersji aplikacji, a wersja jest starsza niż 1000 najnowszych wersji aplikacji.

Więcej informacji znajdziesz w artykule App Distribution obsługuje maksymalnie 1000 wydań.

Gdy aplikacja osiągnie lub przekroczy 150-dniowy limit ważności lub limit 1000 wersji, zostanie usunięta z poziomu pulpitu App Distribution i aplikacji Firebase App Tester. Jeśli tester zainstalował wersję, lokalna wersja aplikacji będzie nadal działać.

Aby wersja aplikacji była dostępna dłużej, zastosuj jedną z tych rekomendacji:

• Zanim 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ą wersję do usługi App Distribution.
• Pobierz wersję i prześlij ją do Cloud Storage, aby przechowywać ją przez długi czas.

Wersje aplikacji wygasają po 150 dniach

Gdy prześlesz wersję aplikacji do Firebase, pojawi się ona na stronie App Distribution przez 150 dni od daty przesłania. Po przesłaniu wersji możesz ją rozpowszechnić wśród testerów, którzy zainstalują ją z aplikacji Firebase App Tester na swoim urządzeniu testowym.

Gdy do daty wygaśnięcia pozostało 30 dni, w aplikacji Firebase App Tester pojawi się powiadomienie o wygaśnięciu wersji aplikacji.

App Distribution obsługuje maksymalnie 1000 wersji

App Distribution pozwala na maksymalnie 1000 wersji aplikacji. Gdy aplikacja osiągnie limit 1000 wersji, App Distribution automatycznie usunie najstarsze wersje, które przekroczyły ten limit.

Jeśli chcesz ręcznie zarządzać wersjami aplikacji, użyj interfejsu API REST App Distribution, aby wyświetlić i usunąć wersje aplikacji zbiorczo.

Jeśli masz pytania, skontaktuj się z zespołem pomocy Firebase.

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

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

Czy w przypadku funkcji Automated Tester obowiązują jakieś limity przydziału?

Firebase App Distribution korzysta z infrastruktury Firebase Test Lab, a limity i ceny są takie same. Limity testów są określane na podstawie liczby testów przeprowadzanych dziennie. Więcej informacji o testowaniu limitów i płatności znajdziesz w artykule Poziomy wykorzystania, limity i ceny w usłudze Test Lab.

Jakie są limity prób ponownego wykonania testu w przypadku przekroczenia limitu?

Jeśli przekroczysz limit, pojawią się błędy związane z przekroczeniem limitu. Resetowanie limitów trwa około 24 godzin, więc nie należy powtarzać prób do momentu, gdy limit zostanie zwolniony. Jeśli jednak pojawią się błędy związane z infrastrukturą testera automatycznego, spróbuj ponownie od razu, a zapytania będą prawdopodobnie skuteczniejsze.

Jakich uprawnień potrzebuję, aby korzystać z funkcji testowania automatycznego w wersji beta?

Aby uruchamiać testy za pomocą funkcji Automated Tester, musisz mieć dostęp do edycji projektu Firebase.

Jak usunąć konto testera?

Aby usunąć konto testowe App Distribution i powiązane z nim dane, wykonaj te czynności w kolejności:

1. Otwórz stronę https://appdistribution.firebase.google.com i zaloguj się na konto Google.

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

   Usuń konto.

3. Opcjonalnie: w uprawnieniach konta Google cofnij dostęp aplikacji Firebase App Distribution. Pamiętaj, że cofnięcie dostępu bez wcześniejszego usunięcia konta App Distribution nie powoduje usunięcia danych ani konta testera.