Check out what’s new from Firebase at Google I/O 2022. Learn more

Dystrybuuj aplikacje na iOS do testerów za pomocą interfejsu Firebase CLI

Kompilacje możesz dystrybuować do testerów za pomocą interfejsu wiersza polecenia Firebase. Narzędzie CLI pozwala określić testerów i informacje o wersji dla kompilacji oraz odpowiednio dystrybuować kompilację.

Zanim zaczniesz

Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu Apple .

Jeśli nie używasz żadnych innych produktów Firebase, wystarczy, że utworzysz projekt i zarejestrujesz swoją aplikację. Jeśli jednak zdecydujesz się na korzystanie z dodatkowych produktów w przyszłości, pamiętaj o wykonaniu wszystkich kroków na stronie, do której prowadzi link powyżej.

Krok 1 . Zbuduj swoją aplikację

Gdy będziesz gotowy do rozpowszechniania wstępnej wersji aplikacji wśród testerów, utwórz podpisane archiwum dystrybucji. Możesz używać normalnego procesu kompilacji, o ile spełniasz następujące wymagania:

  • Aby rozpowszechniać swoją aplikację poza zespołem programistów, musisz użyć profilu dystrybucji Ad Hoc lub Enterprise.
  • Jeśli Twoja aplikacja korzysta z Game Center, APNs (a co za tym idzie Cloud Messaging ) lub iCloud, upewnij się, że Twój profil aprowizacji używa jawnego identyfikatora aplikacji, a nie identyfikatora wieloznacznego.
  • Jeśli używasz profilu dystrybucji Ad Hoc, dołącz unikalne identyfikatory urządzeń (UDID) urządzeń testerów. Ponieważ nowi testerzy iOS zarejestrują się w Twoim programie testowym, musisz zaktualizować profil aprowizacji przy użyciu identyfikatorów UDID ich urządzeń. Zobacz Rejestracja dodatkowych urządzeń testujących .
  • Zaktualizowano widoczny dla użytkownika numer wersji celu kompilacji ( Version ) i unikalny numer kompilacji ( Build ). Jeśli wprowadzono zmiany w kodzie od ostatniej kompilacji (to znaczy, że nie odbudowujesz tylko w celu aktualizacji zarejestrowanych urządzeń), nie musisz aktualizować wersji i numerów kompilacji.

Po zakończeniu kompilacji zapisuje plik IPA i niektóre pliki dziennika w określonym folderze. Rozpowszechniasz plik IPA do testerów w następujących krokach.

Krok 2 . Dystrybuuj swoją aplikację wśród testerów

Aby rozpowszechnić aplikację wśród testerów, 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 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ć swoją aplikację i rozpowszechnić ją wśród testerów. Użyj następujących parametrów, aby skonfigurować dystrybucję:

    appdistribution:opcje dystrybucji
    --app

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

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

    Token odświeżania, który jest drukowany podczas uwierzytelniania środowiska CI za pomocą interfejsu Firebase CLI (więcej informacji można znaleźć w artykule Korzystanie z interfejsu wiersza polecenia z systemami CI ).

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

    Informacje o wersji dla tej kompilacji.

    Informacje o wersji można określić bezpośrednio:

    --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 oddzielonych 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ć (patrz Zarządzanie testerami ). Grupy są określone za pomocą aliasy grupowe , które możesz sprawdzić w konsoli Firebase.

    Możesz określić grupy jako listę rozdzielaną przecinkami:

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

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

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

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

    Na przykład:

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

    Oprócz rozpowszechniania wydań możesz również 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 wydań w Twoim projekcie. Pamiętaj, że testerzy, którzy zostali niedawno usunięci, mogą nadal przez pewien czas zachować dostęp do Twoich wydań.

    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 również określić testerów za pomocą --file /path/to/testers.txt .

Po rozesłaniu kompilacji staje się ona dostępna w panelu dystrybucji aplikacji konsoli Firebase przez 150 dni (pięć miesięcy). Gdy kompilacja minie 30 dni od wygaśnięcia, powiadomienie o wygaśnięciu pojawi się zarówno w konsoli, jak i na liście kompilacji testera na urządzeniu testowym.

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

Testerzy mają 30 dni na zaakceptowanie zaproszenia do przetestowania aplikacji przed jej wygaśnięciem. Po upływie 5 dni od wygaśnięcia zaproszenia w konsoli Firebase obok testera wersji pojawia się informacja o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie za pomocą menu rozwijanego w wierszu testera.

Następne kroki