Z tego przewodnika dowiesz się, jak rozpowszechniać pliki APK wśród testerów za pomocą interfejsu wiersza poleceń Firebase. Narzędzie w wersji CLI umożliwia określenie testerów i notatek dotyczących kompilacji, a następnie rozprowadzanie kompilacji.
Zanim zaczniesz
Dodaj Firebase do swojego projektu na Androida, chyba że masz to już za sobą.
Jeśli nie używasz żadnych innych usług Firebase, musisz tylko utworzyć projekt i zarejestrować aplikację. Jeśli jednak w przyszłości zdecydujesz się na korzystanie z dodatkowych usług, wykonaj wszystkie czynności opisane na stronie, do której link znajduje się powyżej.
Krok 1. Utwórz aplikację
Gdy będziesz gotowy do rozpowszechniania przedpremierowej wersji aplikacji do testów, skompiluj plik APK w ramach zwykłego procesu. Musisz podpisać plik APK kluczem debugowania lub kluczem podpisywania aplikacji.
Krok 2. Udostępnianie aplikacji testerom
Aby udostępnić aplikację testerom, prześlij jej plik za pomocą interfejsu wiersza poleceń Firebase:
- Zainstaluj najnowszą wersję interfejsu wiersza poleceń Firebase lub zaktualizuj go do tej wersji (zalecamy pobranie samodzielnego pliku binarnego dla interfejsu wiersza poleceń odpowiedniego dla Twojego systemu operacyjnego). Zaloguj się i sprawdź, czy masz dostęp do swoich projektów. .
- Na stronie App Distribution konsoli Firebase wybierz aplikację, którą chcesz rozpowszechniać, a potem kliknij Rozpocznij.
-
Aby przesłać aplikację i udostępnić ją testerom, uruchom polecenie
appdistribution:distribute
. Aby skonfigurować dystrybucję, użyj tych parametrów:appdistribution:distribute options --app
Wymagane: identyfikator aplikacji Firebase Twojej aplikacji. Identyfikator aplikacji znajdziesz w konsoli Firebase na stronie ustawień ogólnych.
--app 1:1234567890:android:0a1b2c3d4e5f67890
--token
Token odświeżania, który jest wyświetlany podczas uwierzytelniania środowiska CI za pomocą interfejsu wiersza poleceń Firebase (więcej informacji znajdziesz w artykule Używanie interfejsu wiersza poleceń z systemami CI ).
--token "$FIREBASE_TOKEN"
--release-notes
--release-notes-file
Informacje o tej kompilacji.
Informacje o wersji możesz podać bezpośrednio:
--release-notes "Text of release notes"
Możesz też podać ścieżkę do pliku tekstowego:
--release-notes-file "/path/to/release-notes.txt"
--testers
--testers-file
adresy e-mail testerów, których chcesz zaprosić.
Testerów możesz wskazać jako listę adresów e-mail rozdzielonych przecinkami:
--testers "ali@example.com, bri@example.com, cal@example.com"
Możesz też podać ścieżkę do 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 artykule Zarządzanie testerami). Grupy są określane za pomocą
aliasów grup , które możesz sprawdzić w konsoli Firebase.Grupy możesz podać w postaci listy rozdzielanej przecinkami:
--groups "qa-team, trusted-testers"
Możesz też podać ścieżkę do pliku tekstowego zawierającego oddzieloną przecinkami listę nazw grup:
--groups-file "/path/to/groups.txt"
--debug
Flaga, którą możesz dołączyć, aby wyświetlić szczegółowe dane wyjściowe dziennika.
--test-devices
--test-devices-file
Poniższe typy dystrybucji są częścią funkcji automatycznych testerów w wersji beta.
Urządzenia testowe, na które chcesz rozpowszechnić kompilacje (patrz Automatyczne testy).
Testerów możesz wskazać 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ż podać ścieżkę do pliku tekstowego zawierającego rozdzielaną średnikami listę urządzeń testowych:
--test-devices-file: "/path/to/test-devices.txt"
--test-username
Nazwa użytkownika do automatycznego logowania się podczas testów automatycznych.
--test-password
--test-password-file
Hasło do automatycznego logowania używane podczas testów automatycznych.
Możesz też podać ścieżkę do zwykłego pliku tekstowego zawierającego hasło:
--test-password-file: "/path/to/test-password.txt"
--test-username-resource
Nazwa zasobu dla pola nazwy użytkownika do automatycznego logowania, które ma być używane podczas testów zautomatyzowanych.
--test-password-resource
Nazwa zasobu dla pola hasła do automatycznego logowania, które ma być używane podczas testów zautomatyzowanych.
--test-non-blocking
asynchronicznie uruchamiać testy automatyczne, Wyniki automatycznego testu znajdziesz w konsoli Firebase.
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 wiersza poleceń Firebase wyświetla poniższe linki. Te linki pomogą Ci zarządzać plikami binarnymi oraz upewnić się, że testerzy i inni deweloperzy mają odpowiednią wersję:
firebase_console_uri
– link do konsoli Firebase wyświetlającej pojedyncze wydanie. Możesz udostępnić ten link innym programistom w organizacji.testing_uri
– link do wersji w interfejsie testera (natywnej aplikacji na Androida), która umożliwia wyświetlanie notatek dotyczących wersji i instalowanie aplikacji na urządzeniu. Aby użyć linku, tester musi mieć dostęp do wersji.binary_download_uri
– podpisany link, który bezpośrednio pobiera i instaluje plik binarny aplikacji (plik APK lub AAB). Link wygasa po 1 godzinie.
Zarządzanie testerami i grupami
Oprócz rozpowszechniania wersji za pomocą narzędzi
appdistribution:testers:add
iappdistribution:testers:remove
możesz zapraszać nowych testerów lub usuwać istniejących testerów z projektu Firebase.Po dodaniu testera do projektu Firebase możesz dodawać go do poszczególnych wersji. Po usunięciu testera nie będzie on już mieć dostępu do wersji w Twoim projekcie. Pamiętaj, że niedawno usunięci testerzy nadal mogą zachować dostęp do Twoich wersji przez pewien czas.
Przykład:
firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
Adresy e-mail testerów muszą być oddzielone spacjami. Możesz też określić testerów za pomocą właściwości
--file /path/to/testers.txt
.Jeśli masz dużą liczbę testerów, rozważ użycie grup: możesz użyć poleceń
appdistribution:group:create
iappdistribution:group:delete
, aby utworzyć lub usunąć grupy w projekcie Firebase.Użyj
--group-alias
, aby określić grupę dla poleceńappdistribution:testers:add
iappdistribution:testers:remove
.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 wersji kompilacji będzie ona dostępna w panelu App Distribution konsoli Firebase przez 150 dni (5 miesięcy). Gdy upłynie 30 dni od wygaśnięcia kompilacji, zarówno w konsoli, jak i na liście kompilacji testera na urządzeniu testowym pojawi się odpowiednie powiadomienie.
Testerzy, którzy nie zostali zaproszeni do testowania aplikacji, otrzymują e-maile z zaproszeniem do rozpoczęcia testowania, a dotychczasowi testerzy otrzymują e-maile z powiadomieniami o tym, że nowa kompilacja jest gotowa do przetestowania (instrukcje instalowania aplikacji testowej znajdziesz w przewodniku po konfiguracji aplikacji dla testerów). W konsoli Firebase możesz sprawdzać stan każdego testera – czy zaakceptował on zaproszenie i czy pobrał aplikację.
Testerzy mają 30 dni na zaakceptowanie zaproszenia do testowania aplikacji, zanim utraci ono ważność. Gdy do wygaśnięcia zaproszenia pozostaną 5 dni, w konsoli Firebase obok testera w ramach danej wersji pojawi się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie, korzystając z menu w wierszu testera.
Dalsze kroki
Wprowadź opinie w aplikacji, aby ułatwić testerom przesyłanie opinii na temat aplikacji (w tym zrzutów ekranu).
Dowiedz się, jak wyświetlać alerty w aplikacji testerom, gdy nowe kompilacje aplikacji są dostępne do zainstalowania.
Poznaj sprawdzone metody rozpowszechniania aplikacji na Androida wśród testerów kontroli jakości za pomocą CI/CD.