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

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. 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 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 i rozpowszechniać go testerom. Użyj poniższych parametrów, aby skonfigurować rozkład:

    appdistribution:distribute options
    --app

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

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

    Token odświeżania, który jest drukowany podczas uwierzytelniania CI za pomocą interfejsu wiersza poleceń Firebase (odczyt Używanie interfejsu wiersza poleceń 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 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ż 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 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 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 wyświetlająca pojedynczą wersję. Możesz to udostępnić .
    • 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. 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 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 ). Możesz sprawdzać stan każdego testera – czy zaakceptował on oraz informację o pobraniu aplikacji w konsoli Firebase.

Testerzy mają 30 dni na zaakceptowanie zaproszenia do testowania aplikacji, zanim wygaśnie. 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 została odnowiona, wysyłając ją ponownie za pomocą menu w wierszu testera.

Dalsze kroki