Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

W tym przewodniku opisano, jak rozsyłać pliki APK do testerów za pomocą interfejsu wiersza polecenia Firebase. Narzędzie CLI umożliwia określenie testerów i informacji o wersji dla kompilacji, a następnie odpowiednią dystrybucję kompilacji.

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 utworzyć projekt i zarejestrować swoją aplikację. Jeśli jednak zdecydujesz się w przyszłości korzystać z dodatkowych produktów, pamiętaj o wykonaniu wszystkich kroków na stronie, do której prowadzi link powyżej.

Krok 1. Zbuduj swoją aplikację

Gdy wszystko będzie gotowe do rozpowszechnienia przedpremierowej wersji aplikacji wśród testerów, utwórz plik APK w zwykły sposób. Musisz podpisać plik APK kluczem debugowania lub kluczem podpisywania aplikacji.

Krok 2. Przekaż swoją aplikację testerom

Aby rozpowszechnić aplikację wśród testerów, prześlij plik aplikacji za pomocą interfejsu wiersza polecenia Firebase:

  1. Zainstaluj lub zaktualizuj Firebase CLI do najnowszej wersji (zalecamy pobranie samodzielnego pliku binarnego dla CLI specyficznego dla Twojego systemu operacyjnego). Pamiętaj, aby się zalogować i sprawdzić, 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 rozpowszechnić ją wśród testerów. Użyj następujących parametrów, aby skonfigurować dystrybucję:

    dystrybucja aplikacji: opcje dystrybucji
    --app

    Wymagane : Identyfikator aplikacji Firebase Twojej aplikacji. Identyfikator aplikacji można znaleźć 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ą Firebase CLI (więcej informacji można znaleźć w artykule Korzystanie z 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 wydaniu:

    --release-notes "Text of release notes"

    Lub podaj ś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 oddzieloną przecinkami listę adresów e-mail:

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

    Grupy testerów, które chcesz zaprosić (patrz Zarządzanie testerami ). Grupy są określane za pomocą pseudonimy grupowe , które możesz wyszukać w konsoli Firebase.

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

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

    Lub możesz określić ścieżkę do zwykłego pliku tekstowego zawierającego oddzieloną przecinkami listę nazw grup:

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

    Flaga, którą możesz dołączyć, aby wydrukować 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

    Interfejs wiersza polecenia Firebase wyświetla następujące linki po przesłaniu wersji. Te łącza pomagają zarządzać plikami binarnymi i zapewniają, że testerzy i inni programiści mają odpowiednią wersję:

    • firebase_console_uri — łącze do konsoli Firebase wyświetlającej jedną wersję. Możesz udostępnić ten link innym programistom w swojej organizacji.
    • testing_uri — link do wersji w środowisku testera (aplikacja natywna dla systemu Android), który umożliwia testerom wyświetlanie informacji o wersji i instalowanie aplikacji na swoim urządzeniu. Tester musi mieć dostęp do wersji, aby użyć łącza.
    • binary_download_uri — podpisany link, który bezpośrednio pobiera i instaluje plik binarny aplikacji (plik APK lub AAB). Link wygasa po godzinie.

    Oprócz dystrybucji wersji możesz też używać appdistribution:testers:add i appdistribution:testers:remove aby zapraszać nowych testerów lub usuwać 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ą zachować dostęp do Twoich wersji przez określony 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 .

Po rozpowszechnieniu kompilacji staje się ona dostępna na pulpicie nawigacyjnym Dystrybucja aplikacji w konsoli Firebase przez 150 dni (pięć miesięcy). Gdy kompilacja wygaśnie za 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-maile z zaproszeniami do rozpoczęcia, a obecni testerzy otrzymują powiadomienia e-mail, że nowa kompilacja jest gotowa do przetestowania (przeczytaj przewodnik konfiguracji testera, aby dowiedzieć się, jak zainstalować aplikację testową). Możesz monitorować status każdego testera – czy zaakceptował zaproszenie i czy pobrał aplikację – w konsoli Firebase.

Testerzy mają 30 dni na zaakceptowanie zaproszenia do przetestowania aplikacji przed jego wygaśnięciem. Gdy zaproszenie wygaśnie za 5 dni, w konsoli Firebase obok testera pojawi się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie, korzystając z menu rozwijanego w wierszu testera.

Następne kroki