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

Dystrybuuj aplikacje na Androida do testerów za pomocą interfejsu wiersza polecenia Firebase

W tym przewodniku opisano, jak rozpowszechniać pakiety APK testerom za pomocą interfejsu wiersza polecenia Firebase. Narzędzie CLI pozwala określić testerów i informacje o wersji dla kompilacji, a następnie odpowiednio ją dystrybuować.

Zanim zaczniesz

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

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 przedpremierowej wersji aplikacji wśród testerów, utwórz pakiet APK w normalny sposób. Musisz podpisać plik APK za pomocą klucza debugowania lub klucza podpisywania aplikacji.

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

Aby rozpowszechniać aplikację wśród testerów, prześlij plik aplikacji 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:android: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.apk  \
        --app 1:1234567890:android: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 (przeczytaj przewodnik konfiguracji testera, aby uzyskać instrukcje dotyczące instalowania aplikacji testowej). 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.