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


Na tej stronie znajdziesz pomoc dotyczącą rozwiązywania problemów oraz odpowiedzi na najczęstsze pytania dotyczące rozpowszechniania i testowania aplikacji za pomocą App Distribution.

Rozpowszechnianie aplikacji

Aby rozwiązać problemy, które mogą wystąpić podczas rozpowszechniania aplikacji wśród testerów, skorzystaj z podanych niżej wskazówek.

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 stronę 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.

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.

  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.

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

Dystrybucja pakietów aplikacji na Androida (AAB)

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.

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

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ę App Distribution z Google Play;

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

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 test wewnętrzny – wersja robocza), 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.

Instalowanie i testowanie aplikacji

Skorzystaj z tych wskazówek, aby rozwiązać problemy, które mogą napotkać testerzy podczas instalowania i testowania Twoich aplikacji.

Gdy użytkownik utworzy konto Google, automatycznie otrzyma adres Gmail.

Jeśli tester nie ma adresu Google Workspace ani Gmaila lub woli używać innego adresu e-mail do logowania, 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.

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 do nowych wersji dodasz adres e-mail A, dostęp uzyska adres 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 z 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 mogą nie otrzymywać powiadomień e-mail, jeśli wystąpi jedno z tych zdarzeń:

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

  • 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 Distributionnie 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świetlać 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.

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

Jeśli testowy plik APK nie zainstaluje się na urządzeniu testującego:

  • Sprawdź, czy certyfikaty w nowej wersji są zgodne z certyfikatami w wersji zainstalowanej na urządzeniu testera. System Android zezwala 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 testującego (sprawdź minSdkVersion).

Jeśli aplikacja Tester aplikacji uniemożliwia Ci zalogowanie się i przekierowuje Cię z powrotem na ekran 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 te ustawienia, spróbuj zalogować się ponownie.

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

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

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 konto, na którym nie obowiązują ograniczenia dotyczące instalowania i testowania aplikacji.

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 testowe i u dołu ekranu kliknij przycisk Pobierz Aplikację Testera, aby zainstalować aplikację Android App Tester.

Włączanie funkcji testowania za pomocą pakietu 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 Android SDK App Distribution.

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ą przesłać opinii, wykonaj te czynności:

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

    adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
    
  2. Sprawdź, czy w logach aplikacji nie ma komunikatów o błędach. Aby to zrobić, przefiltruj logi pod kątem „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.

  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 programisty na urządzeniu, wykonując to 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 w swojej aplikacji szczegółowe logowanie pakietu Android SDK App Distribution:

    adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
    
  4. Sprawdź, czy w logach aplikacji nie ma komunikatów o błędach. Aby to zrobić, przefiltruj logi pod kątem „FirebaseAppDistribution”.

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

  1. Aby sprawdzić, czy nie ma komunikatów o błędach, dodaj obiekt OnFailureListener do zadania zwróconego 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 odszukaj ciąg znaków „FirebaseAppDistribution”.

      Jeśli dzienniki wskazują, że nie znaleziono żadnej wersji lub że tester nie ma do niej 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 i czy ma stan Zaakceptowany.

      Jeśli tester nadal nie otrzymuje alertów, poproś go o przestrzeganie tych 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 Test 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 podczas akceptowania zaproszenia do testowania aplikacji.

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

Domyślnie testerzy muszą tylko raz zalogować się na swoje konto Google, 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ę, która wskazuje, czy tester zalogował się już w aplikacji. Więcej informacji znajdziesz w repozytorium GitHub.

Najczęstsze pytania

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.

Testerzy mają 30 dni na zaakceptowanie zaproszenia do przetestowania aplikacji, zanim utraci ono ważność. Gdy do wygaśnięcia zaproszenia pozostanie 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 z danymi testera.

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

  • wersja aplikacji jest starsza niż 150 dni,
  • przekroczysz limit 1000 wersji aplikacji, a wersja aplikacji jest starsza niż 1000 najnowszych wersji aplikacji;

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

Gdy aplikacja osiągnie lub przekroczy limit 150 dni lub limit 1000 wersji, zostanie usunięta z panelu App Distribution i aplikacji Firebase App Tester. Jeśli tester zainstalował wersję, lokalna wersja aplikacji będzie nadal działać.

Aby wersja aplikacji była 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, licząc 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 wydań

App Distribution pozwala na maksymalnie 1000 wersji aplikacji. Gdy liczba wersji osiągnie limit 1000, 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ćusunąć wersje aplikacji zbiorczo.

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

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

Usługa Firebase App Distribution korzysta z infrastruktury Firebase Test Lab, a jej limity i ceny są takie same. Limity testów są mierzone na podstawie liczby testów przeprowadzonych 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.

Jeśli przekroczysz limit, pojawią się błędy związane z przekroczeniem limitu. Limity są resetowane w ciągu 24 godzin, więc nie należy ich powtarzać, dopóki nie zostaną odblokowane. Jeśli jednak pojawią się błędy związane z infrastrukturą testera automatycznego, spróbuj ponownie od razu.

Aby uruchamiać testy za pomocą funkcji Automated Tester, musisz mieć dostęp edytujący w projekcie Firebase.

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  (Zarządzaj kontem).

    Usuń konto.

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