Udostępnianie aplikacji na Androida testerom za pomocą interfejsu wiersza poleceń Firebase


Z tego przewodnika dowiesz się, jak rozpowszechniać pakiety aplikacji na Androida (AAB) wśród testerów za pomocą interfejsu wiersza poleceń Firebase. Narzędzie wiersza poleceń pozwala określić testerów i informacje o wersji kompilacji, a następnie odpowiednio rozpowszechniać kompilację.

App Distribution integruje się z usługą wewnętrznego udostępniania aplikacji w Google Play, aby przetwarzać przesyłane przez Ciebie pakiety AAB i przesyłać pliki APK zoptymalizowane pod kątem konfiguracji urządzeń testerów. Rozpowszechnianie aplikacji z uwzględnieniem AAB umożliwia:

  • Uruchom zoptymalizowane pliki APK (dostarczane przez Google Play), które są zoptymalizowane pod kątem urządzeń testerów.

  • Wykrywanie i debugowanie problemów związanych z konkretnymi urządzeniami.

  • Testowanie funkcji pakietów aplikacji, takich jak Play Feature Delivery i Play Asset Delivery.

  • Zmniejsz rozmiar pobieranych plików dla testerów.

Wymagane uprawnienia

Aby przesłać pakiety aplikacji na Androida do usługi App Distribution, musisz połączyć swoją aplikację Firebase z aplikacją w usłudze Google Play. Aby wykonać te działania, musisz mieć wymagany poziom dostępu.

Jeśli nie masz niezbędnego dostępu do Firebase, poproś właściciela projektu Firebase o przypisanie Ci odpowiedniej roli w ustawieniach uprawnień w konsoli Firebase. Jeśli masz pytania dotyczące dostępu do projektu Firebase, w tym znajdowania lub przypisywania właściciela, zapoznaj się z artykułem „Uprawnienia i dostęp do projektów Firebase”.

Poniższa tabela dotyczy łączenia aplikacji Firebase z aplikacją w Google Play oraz przesyłania pakietów aplikacji na Androida.

Działanie w konsoli Firebase Wymagane uprawnienia IAM Role uprawnień, które domyślnie zawierają wymagane uprawnienia Dodatkowe wymagane role
Połącz aplikację Firebase z aplikacją w Google Play firebase.playLinks.update jedną z tych ról: dostęp do konta dewelopera Google Play w roli administratora,
Przesyłanie pakietów AAB do usługi App Distribution firebaseappdistro.releases.update jedną z tych ról: ––

Zanim zaczniesz

  1. Jeśli nie zostało to jeszcze zrobione, dodaj Firebase do projektu na Androida. Po zakończeniu tego procesu w projekcie Firebase masz już aplikację Firebase na Androida.

    Jeśli nie korzystasz z żadnych innych usług Firebase, musisz tylko utworzyć projekt i zarejestrować aplikację. Jeśli zdecydujesz się na używanie dodatkowych usług, wykonaj wszystkie czynności opisane w artykule Dodawanie Firebase do projektu na Androida.

  2. Aby utworzyć połączenie Firebase z Google Play i przesyłać pakiety aplikacji na Androida, sprawdź, czy Twoja aplikacja spełnia te wymagania:

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

    • Aplikację w Google Play konfiguruje się w panelu aplikacji i jest ona rozpowszechniana na jednej ze ścieżek Google Play (test wewnętrzny, test zamknięty, test otwarty lub wersja produkcyjna).

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

  3. Aby połączyć aplikację Firebase na Androida z kontem dewelopera w Google Play:

    1. W konsoli Firebase otwórz Ustawienia projektu, a następnie kliknij kartę Integracje.

    2. Na karcie Google Play kliknij Połącz.
      Jeśli masz już połączenia z Google Play, kliknij Zarządzaj.

    3. Postępuj zgodnie z instrukcjami na ekranie, aby włączyć integrację App Distribution i wybrać aplikacje Firebase na Androida, które chcesz połączyć z Google Play.

    Dowiedz się więcej o łączeniu z Google Play.

Krok 1. Tworzenie aplikacji

Gdy zechcesz udostępnić testerom przedpremierową wersję aplikacji, utwórz pakiet AAB (instrukcje znajdziesz w dokumentacji Androida Studio).

Krok 2. Udostępnianie aplikacji testerom

Aby rozpowszechnić aplikację wśród testerów, prześlij plik aplikacji za pomocą interfejsu wiersza poleceń Firebase:

  1. Zainstaluj lub zaktualizuj interfejs wiersza poleceń Firebase do najnowszej wersji (zalecamy pobranie samodzielnego pliku binarnego interfejsu wiersza poleceń dostosowanego do Twojego systemu operacyjnego). Zaloguj się i sprawdź, czy masz dostęp do swoich projektów. .
  2. Na stronie App Distribution w konsoli Firebase wybierz aplikację, którą chcesz udostępnić, a następnie kliknij Rozpocznij.

  3. Uruchom polecenie appdistribution:distribute, aby przesłać aplikację i rozpowszechnić ją wśród testerów. Aby skonfigurować dystrybucję, użyj tych parametrów:

    appdistribution:rozsyłanie opcji
    --app

    Wymagane: identyfikator aplikacji Firebase Twojej aplikacji. Identyfikator aplikacji znajdziesz w konsoli Firebase na stronie Ogólne ustawienia.

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    token odświeżania wydrukowany podczas uwierzytelniania środowiska CI za pomocą interfejsu wiersza poleceń Firebase (więcej informacji znajdziesz w artykule Używanie interfejsu wiersza poleceń w systemach CI ). 

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    Informacje o tej kompilacji.

    Możesz podać informacje o wersji bezpośrednio:

    --release-notes "Text of release notes"

    Możesz też podać ścieżkę do pliku tekstowego:

    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    adresy e-mail testerów, których chcesz zaprosić.

    Testerów możesz wskazać jako listę adresów e-mail rozdzielonych przecinkami:

    --testers "ali@example.com, bri@example.com, cal@example.com"

    Możesz też podać ścieżkę do pliku tekstowego zawierającego listę oddzielonych przecinkami adresów e-mail:

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    Grupy testerów, które chcesz zaprosić (więcej informacji znajdziesz w artykule Zarządzanie testerami). Grupy są określane za pomocą aliasów grup, które możesz sprawdzić w konsoli Firebase.

    Grupy możesz podać w postaci listy rozdzielanej przecinkami:

    --groups "qa-team, trusted-testers"

    Możesz też podać ścieżkę do pliku tekstowego zawierającego oddzieloną przecinkami listę nazw grup:

    --groups-file "/path/to/groups.txt"
    --debug

    Flaga, którą możesz dołączyć, aby wydrukować szczegółowy dziennik.
    --test-devices
    --test-devices-file

    Poniższe typy dystrybucji są częścią funkcji automatycznych testerów w wersji beta.

    Urządzenia testowe, na które chcesz rozpowszechnić kompilacje (patrz Automatyczne testy).

    Testerów możesz podać w postaci listy oddzielonych przecinkami adresów e-mail:

    --test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

    Możesz też podać ścieżkę do pliku tekstowego zawierającego listę urządzeń testowych rozdzielonych średnikami:

    --test-devices-file: "/path/to/test-devices.txt"
    --test-username

    Nazwa użytkownika do automatycznego logowania, która ma być używana podczas testów zautomatyzowanych.
    --test-password
    --test-password-file

    Hasło do automatycznego logowania, które będzie używane podczas testów zautomatyzowanych.

    Możesz też podać ścieżkę do zwykłego pliku tekstowego zawierającego hasło:

    --test-password-file: "/path/to/test-password.txt"
    --test-username-resource

    Nazwa zasobu w polu nazwy użytkownika na potrzeby automatycznego logowania, które jest używane podczas testów automatycznych.
    --test-password-resource

    Nazwa zasobu dla pola hasła do automatycznego logowania, które ma być używane podczas testów zautomatyzowanych.
    --test-non-blocking

    asynchronicznie przeprowadzać testy automatyczne; Wyniki automatycznego testu znajdziesz w konsoli Firebase.

    Przykład:

    firebase appdistribution:distribute test.aab  \
    --app 1:1234567890:android:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

    Po przesłaniu wersji wiersz poleceń Firebase wyświetla te linki: Te linki pomogą Ci zarządzać plikami binarnymi i zadbać o to, aby testerzy i inni deweloperzy mieli odpowiednią wersję:

    • firebase_console_uri – link do konsoli Firebase wyświetlającej pojedyncze wydanie. Możesz udostępnić ten link innym deweloperom w swojej organizacji.
    • testing_uri – link do wersji w interfejsie testera (natywnej aplikacji na Androida), która umożliwia wyświetlanie notatek dotyczących wersji i instalowanie aplikacji na urządzeniu. Tester musi mieć dostęp do wersji, aby użyć linku.
    • binary_download_uri – podpisany link, który bezpośrednio pobiera i instaluje binarną aplikację (plik APK lub AAB). Link wygasa po godzinie.

    Zarządzanie testerami i grupami

    Oprócz rozpowszechniania wersji za pomocą narzędzi appdistribution:testers:add i appdistribution:testers:remove możesz zapraszać nowych testerów lub usuwać istniejących testerów z projektu Firebase.

    Po dodaniu testera do projektu Firebase możesz go dodać do poszczególnych wersji. Po usunięciu testera nie będzie on już mieć dostępu do wersji w Twoim projekcie. Pamiętaj, że niedawno usunięci testerzy nadal mogą zachować dostęp do Twoich wersji przez pewien czas.

    Przykład:

    firebase appdistribution:testers:add anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com

    Adresy e-mail testerów muszą być oddzielone spacjami. Testerów możesz też określić za pomocą parametru --file /path/to/testers.txt.

    Jeśli masz dużą liczbę testerów, rozważ użycie grup: możesz użyć poleceń appdistribution:group:create i appdistribution:group:delete, aby utworzyć lub usunąć grupy w projekcie Firebase.

    Użyj --group-alias, aby określić grupę dla poleceń appdistribution:testers:add i appdistribution:testers:remove.

    Przykład:

    firebase appdistribution:group:create "QA team" qa-team

firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:group:delete qa-team

Po rozpowszechnieniu wersji kompilacji będzie ona dostępna w panelu App Distribution konsoli Firebase przez 150 dni (5 miesięcy). Gdy do wygaśnięcia wersji pozostało 30 dni, w konsoli i na liście wersji na urządzeniu testowym testera pojawi się powiadomienie o wygaśnięciu.

Testerzy, którzy nie zostali zaproszeni do testowania aplikacji, otrzymują e-maile z zaproszeniem do rozpoczęcia testowania, a dotychczasowi testerzy otrzymują e-maile z powiadomieniami o tym, że nowa kompilacja jest gotowa do przetestowania (instrukcje instalowania aplikacji testowej znajdziesz w przewodniku po konfiguracji aplikacji dla testerów). Stan każdego testującego (czy zaakceptował zaproszenie i czy pobrał aplikację) możesz sprawdzać w konsoli Firebase.

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 danej wersji pojawi się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie, korzystając z menu w wierszu testera.

Dalsze kroki