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

.

Z tego przewodnika dowiesz się, jak udostępniać pliki APK testerom. 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

Dodaj Firebase do swojego urządzenia z Androidem, chyba że masz to już za sobą projekt.

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. Utwórz aplikację

Gdy zechcesz udostępnić testerom przedpremierową wersję aplikacji, i utwórz pakiet APK w zwykły sposób. Musisz podpisać plik APK za pomocą debugowania lub klucza podpisywania aplikacji.

Krok 2. Udostępnianie aplikacji testerom

Aby udostępnić aplikację testerom, prześlij jej plik za pomocą Interfejs 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 Rozpowszechnianie aplikacji w konsoli Firebase wybierz aplikację, którą chcesz udostępnić, i kliknij Rozpocznij.

  3. Uruchom polecenie appdistribution:distribute, aby przesłać aplikację i i rozpowszechniać go wśród testerów. Użyj poniższych parametrów, aby skonfigurować rozkład:

    appdistribution:opcja dystrybuowania
    --app

    Wymagany: identyfikator aplikacji Firebase. Znajdziesz ją w konsoli Firebase, na stronie Ogólne Strona ustawień.

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

    Token odświeżania, który jest drukowany podczas uwierzytelniania CI za pomocą interfejsu wiersza poleceń Firebase (przeczytaj Używanie interfejsu wiersza poleceń razem z CI systemy ). 

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

    Informacje o wersji tej kompilacji.

    Informacje o wersji możesz podać bezpośrednio:

    --release-notes "Text of release notes"

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

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

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

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

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

    Możesz też określić ścieżkę do 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 określa się przy użyciu aliasów grup, których możesz używać możesz znaleźć w konsoli Firebase.

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

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

    Możesz też określić ścieżkę do pliku tekstowego zawierającego rozdzielana przecinkami lista 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

    Poniższe typy dystrybucji są częścią funkcji automatycznych testerów 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ż określić ścieżkę do pliku tekstowego zawierającego lista urządzeń testowych rozdzielana średnikami:

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

    Nazwa użytkownika do automatycznego logowania się podczas testów automatycznych.
    --test-password
    --test-password-file

    Hasło do automatycznego logowania używane podczas testów automatycznych.

    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 w polu hasła na potrzeby automatycznego logowania się podczas testów automatycznych.
    --test-non-blocking

    asynchronicznie uruchamiać testy automatyczne, Otwórz konsolę Firebase, aby wyświetlić wyniki automatycznych testów.

    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 interfejs wiersza poleceń Firebase wyświetla poniższe 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 funkcji Konsola Firebase z wyświetloną pojedynczą wersją. Możesz to udostępnić .
    • testing_uri – link do wersji w testerze doświadczenie (aplikacja natywna na Androida) który umożliwia testerom wyświetlenie wersji notatki i zainstalować aplikację na urządzeniu. Tester potrzebuje dostęp do wydania, aby użyć linku.
    • binary_download_uri – podpisany link, który bezpośrednio pobiera i instaluje plik binarny aplikacji (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. Gdy usuniesz testera, utraci on dostęp do: 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, możesz użyć grup: Możesz użyć tych usług: appdistribution:group:create i appdistribution:group:delete, aby utworzyć lub usunąć grupy w Firebase w projektach AI.

    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

Gdy rozpowszechnisz kompilację, staje się ona dostępna w Panel Rozpowszechniania aplikacji w konsoli Firebase przez 150 dni (5 miesięcy). Jeśli upłynie 30 dni od wygaśnięcia kompilacji, w obu konsolę i listę kompilacji na urządzeniu testowym.

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 ). Możesz sprawdzać stan każdego testera – czy zaakceptował on oraz czy pobrał aplikację w konsoli Firebase.

Testerzy mają 30 dni na zaakceptowanie zaproszenia do testowania aplikacji, zanim wygaśnie. Jeśli zaproszenie wygasa po 5 dniach, w sekcji Konsola Firebase obok testera przy wersji. Zaproszenie można została odnowiona, wysyłając ją ponownie za pomocą menu w wierszu testera.

Dalsze kroki