Dystrybuuj aplikacje na iOS wśród testerów, korzystając z interfejsu wiersza polecenia Firebase

Możesz rozpowszechniać kompilacje wśród testerów, korzystając z interfejsu wiersza polecenia Firebase. Narzędzie CLI umożliwia określenie testerów i informacji o wersji dla kompilacji oraz odpowiednią dystrybucję kompilacji.

Aby udostępnić aplikację testerom, prześlij plik IPA za pomocą interfejsu wiersza polecenia Firebase:

  1. Zainstaluj lub zaktualizuj do najnowszej wersji Firebase CLI (zalecamy pobranie samodzielnego pliku binarnego dla interfejsu CLI specyficznego dla Twojego systemu operacyjnego). Zaloguj się i sprawdź, czy masz dostęp do swoich projektów.
  2. Na stronie Dystrybucja aplikacji w konsoli Firebase wybierz aplikację, którą chcesz rozpowszechniać, a następnie kliknij Rozpocznij .
  3. Uruchom polecenie appdistribution:distribute , aby przesłać aplikację i udostępnić ją testerom. Aby skonfigurować dystrybucję, użyj następujących parametrów:

    dystrybucja aplikacji:opcje dystrybucji
    --app

    Wymagane : identyfikator aplikacji Firebase Twojej aplikacji. Identyfikator aplikacji znajdziesz w konsoli Firebase, na stronie Ustawienia ogólne .

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

    Token odświeżania drukowany podczas uwierzytelniania środowiska CI za pomocą interfejsu CLI Firebase (więcej informacji można znaleźć w artykule Używanie interfejsu CLI w systemach CI ).

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

    Informacje o wersji dla tej kompilacji.

    Możesz bezpośrednio określić informacje o wersji:

    --release-notes "Text of release notes"

    Lub określ ś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 określić testerów jako listę adresów e-mail rozdzielonych przecinkami:

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

    Możesz też określić ścieżkę do zwykłego pliku tekstowego zawierającego listę adresów e-mail rozdzielonych przecinkami:

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

    Grupy testerów, które chcesz zaprosić (więcej informacji znajdziesz w Zarządzaj testerami ). Grupy są określane przy użyciu aliasy grupowe , które możesz sprawdzić w konsoli Firebase.

    Grupy można określić w formie listy rozdzielanej przecinkami:

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

    Możesz też określić ścieżkę do zwykłego pliku tekstowego zawierającego listę nazw grup rozdzielonych przecinkami:

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

    Flaga, którą możesz dołączyć, aby wydrukować szczegółowe dane wyjściowe dziennika.

    --test-devices
    --test-devices-file

    Następujące typy dystrybucji są częścią funkcji beta automatycznego testera .

    Urządzenia testowe, do których chcesz dystrybuować kompilacje (zobacz Testy automatyczne ).

    Możesz określić testerów jako listę adresów e-mail rozdzielonych przecinkami:

    --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 zwykłego 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 będzie używana podczas testów automatycznych .

    --test-password
    --test-password-file

    Hasło do automatycznego logowania, które będzie wykorzystywane podczas testów automatycznych .

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

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

    Nazwa zasobu pola nazwy użytkownika do automatycznego logowania, które będzie używane podczas testów automatycznych .

    --test-password-resource

    Nazwa zasobu pola hasła do automatycznego logowania, które będzie używane podczas testów automatycznych .

    --test-non-blocking

    Uruchamiaj testy automatyczne asynchronicznie. Odwiedź konsolę Firebase, aby zobaczyć wyniki testów automatycznych.

    Na przykład:

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

    Po przesłaniu wersji interfejs Firebase CLI wyświetla następujące linki. Te linki pomogą Ci zarządzać plikami binarnymi i zapewnić testerom i innym programistom właściwą wersję:

    • firebase_console_uri — łącze do konsoli Firebase wyświetlające pojedynczą wersję. Możesz udostępnić ten link innym programistom w swojej organizacji.
    • testing_uri — łącze do wersji w środowisku testera (klip internetowy iOS), które umożliwia testerom przeglądanie informacji o wersji i instalowanie aplikacji na swoim urządzeniu. Tester musi mieć dostęp do wydania, aby móc skorzystać z linku.
    • binary_download_uri — podpisany link, który bezpośrednio pobiera i instaluje plik binarny aplikacji (plik IPA). Link wygasa po godzinie.

    Zarządzaj testerami i grupami

    Oprócz dystrybucji wydań możesz także użyć appdistribution:testers:add i appdistribution:testers:remove aby zaprosić nowych testerów lub usunąć istniejących testerów z projektu Firebase.

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

    Na przykład:

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

    E-maile testerów muszą być oddzielone spacją. Możesz także określić testerów za pomocą --file /path/to/testers.txt .

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

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

    Na 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 kompilacji staje się ona dostępna w panelu dystrybucji aplikacji w konsoli Firebase przez 150 dni (pięć miesięcy). Gdy do wygaśnięcia kompilacji zostanie 30 dni, powiadomienie o wygaśnięciu pojawi się zarówno w konsoli, jak i na liście kompilacji testera na jego urządzeniu testowym.

Testerzy, którzy nie zostali zaproszeni do testowania aplikacji, otrzymują e-mailem zaproszenia do rozpoczęcia, a obecni testerzy otrzymują powiadomienia e-mailem, że nowa kompilacja jest gotowa do testowania. Aby dowiedzieć się, jak zainstalować aplikację testową, zobacz temat Konfiguracja jako tester . Możesz monitorować status każdego testera – czy przyjął zaproszenie i czy pobrał aplikację – w konsoli Firebase.

Testerzy mają 30 dni na przyjęcie zaproszenia do przetestowania aplikacji, zanim wygaśnie. Gdy do wygaśnięcia zaproszenia pozostało 5 dni, w konsoli Firebase obok testera w wersji pojawi się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie za pomocą menu rozwijanego w wierszu testera.

Następne kroki