W tym przewodniku opisano, jak dystrybuować 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 korzystasz z innych produktów Firebase, wystarczy, że utworzysz projekt i zarejestrujesz swoją aplikację. Jeśli jednak w przyszłości zdecydujesz się skorzystać z dodatkowych produktów, pamiętaj o wykonaniu wszystkich kroków opisanych na stronie, do której link znajduje się powyżej.
Krok 1. Zbuduj swoją aplikację
Gdy wszystko będzie gotowe do udostępnienia testerom wersji wstępnej aplikacji, utwórz plik APK w normalny sposób. Musisz podpisać plik APK kluczem debugowania lub kluczem podpisywania aplikacji.
Krok 2. Udostępnij swoją aplikację testerom
Aby udostępnić aplikację testerom, prześlij plik aplikacji za pomocą interfejsu wiersza polecenia Firebase:
- 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.
- Na stronie Dystrybucja aplikacji w konsoli Firebase wybierz aplikację, którą chcesz rozpowszechniać, a następnie kliknij Rozpocznij .
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:android: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.
Na 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 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
— link do wersji w środowisku testera (natywna aplikacja na Androida), który 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 APK lub AAB). Link wygasa po godzinie.
Zarządzaj testerami i grupami
Oprócz dystrybucji wydań możesz także użyć
appdistribution:testers:add
iappdistribution: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
iappdistribution:group:delete
, aby utworzyć lub usunąć grupy w projekcie Firebase.Użyj opcji
--group-alias
, aby określić grupę dlaappdistribution:testers:add
iappdistribution: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-mail z zaproszeniami do rozpoczęcia, a obecni testerzy otrzymują powiadomienia e-mailem, że nowa kompilacja jest gotowa do testowania (przeczytaj przewodnik konfiguracji testera , aby uzyskać instrukcje dotyczące instalowania aplikacji testowej). 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
Zaimplementuj opinie w aplikacji , aby ułatwić testerom przesyłanie opinii na temat Twojej aplikacji (w tym zrzutów ekranu).
Dowiedz się, jak wyświetlać testerom alerty w aplikacji , gdy będą dostępne do zainstalowania nowe wersje Twojej aplikacji.
Poznaj najlepsze praktyki dystrybucji aplikacji na Androida wśród testerów kontroli jakości przy użyciu CI/CD .