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


Z tego przewodnika dowiesz się, jak rozpowszechniać pliki APK wśród testerów za pomocą interfejsu wiersza poleceń Firebase. Narzędzie wiersza poleceń pozwala wskazać testerów informacji o wersji dotyczących kompilacji, a następnie odpowiednio ją rozpowszechnia.

Zanim zaczniesz

Jeśli nie zostało to jeszcze zrobione, dodaj Firebase do projektu na Androida.

Jeśli nie korzystasz z żadnych innych usług Firebase, musisz tylko utworzyć projekt i zarejestrować aplikację. Jeśli jednak zdecydujesz się na korzystanie z dodatkowych w przyszłości, wykonaj wszystkie czynności podane na stronie pod linkiem powyżej.

Krok 1. Tworzenie aplikacji

Gdy będziesz gotowy do rozpowszechniania przedpremierowej wersji aplikacji do testów, skompiluj plik APK w ramach zwykłego procesu. Plik APK musi być podpisany kluczem debugowania lub kluczem podpisywania aplikacji.

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 w projektach AI.
  2. Na stronie App Distribution w konsoli Firebase wybierz aplikację, którą chcesz udostępnić, i 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:opcja dystrybuowania
    --app

    Wymagane: identyfikator aplikacji Firebase Twojej aplikacji. Znajdziesz ją 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.

    Informacje o wersji możesz podać 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 zwykłego pliku tekstowego zawierającego rozdzielana przecinkami lista adresów e-mail:

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

    Grupy testerów, które chcesz zaprosić (patrz: Zarządzaj 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 rozdzieloną przecinkami listę nazw grup:

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

    Flaga, którą możesz dołączyć, aby wyświetlić szczegółowe dane wyjściowe dziennika.
    --test-devices
    --test-devices-file

    Te typy dystrybucji są częścią funkcji testowania automatycznego w wersji beta.

    Urządzenia testowe, na które chcesz rozpowszechniać kompilacje (patrz Testy automatyczne).

    Możesz podać testerów jako listę adresów e-mail rozdzielonych przecinkami adresy:

    --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ż określić ścieżkę do pliku tekstowego zawierającego hasło:

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

    Nazwa zasobu dla pola nazwy użytkownika do automatycznego logowania, które ma być używane podczas testów zautomatyzowanych.
    --test-password-resource

    Nazwa zasobu w polu hasła na potrzeby automatycznego logowania podczas testów automatycznych.
    --test-non-blocking

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

    Przykład:

    firebase appdistribution:distribute test.apk  \
    --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 sprawdzić, czy testerzy i inni którzy mają właściwą wersję:

    • firebase_console_uri – link do konsoli Firebase, na której wyświetla się pojedynczy film. Możesz udostępnić ten link innym programistom w organizacji.
    • testing_uri – link do wersji w interfejsie testów (natywnej aplikacji na Androida), która umożliwia testerom wyświetlanie informacji o wersji i instalowanie aplikacji na urządzeniu. Aby użyć linku, tester musi mieć dostęp do wersji.
    • 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, możesz też używać appdistribution:testers:add i appdistribution:testers:remove, aby zaprosić lub usunąć testerów dotychczasowych testerów z projektu Firebase.

    Po dodaniu testera do projektu Firebase, możesz dodać je 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 mogą zachowają dostęp do swoich 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ć rozdzielone spacją. Możesz też określić testerów za pomocą funkcji --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: appdistribution:testers:add i Polecenia 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 rozszerzonej 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, otrzymają e-maile z zaproszeniami a dotychczasowi testerzy otrzymają e-maile z powiadomieniami o nowej kompilacji. jest gotowy do testowania (przeczytaj przewodnik po konfiguracji dla testerów , aby dowiedzieć się, jak zainstalować test ). 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 za pomocą menu w wierszu testującego.

Dalsze kroki